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翻译 这 本 书 算 是 圆 了 我 学 生 时 期 的 一 个 心愿 : 在 一 本 纸 质 书 的 封面 上 印 上 自己 的 名 字 。 作为 
一 名 IT 技术 人 员 ， 总 是 感 党 自己 的 时 间 不 够 用 ， 因 为 技术 永 无 止境 ， 让 我 从 不 敢 懈 念 。 以 前 阅 
读 过 许多 “大 侠 ” 翻 译 的 不 少 书籍 ， 但 对 于 译 者 的 伴 酸 和 困难 都 没有 太 大 的 感触 。 直 到 上 自己 开始 
实际 动手 翻译 时 , 才 发 现 整个 过 程 中 心情 都 是 志 起 不安 的 , 担心 自己 的 翻译 不 能 清楚 传达 原 书 作 
者 的 真实 意图 , 害怕 目 己 的 译文 会 让 读者 觉得 乏味 , 于 是 , 总 是 会 对 不 满意 的 翻译 片段 心 生 焦虑 ， 
也 尽 了 自己 最 大 努力 对 译文 的 选 词 和 顺序 进行 反复 的 推 殴 和 黄 酌 。 当 然 , 由 于 自身 能 力 和 精力 有 
限 ， 相 信 大 家 肯定 会 找 出 翻译 中 需要 改进 的 地 方 ， 在 此 先行 感谢 大 家 的 热心 指正 。 

原 书 内 容 的 精彩 我 就 不 多 袭 述 。 本 书 主要 针对 C# 程 序 员 ， 基 于 敏捷 方法 论 ， 介绍 使 用 
Microsoft .NET Framework 进行 C# 编程 的 当前 最 佳 实践 , 其 中 包括 了 从 敏捷 项 目 过 程 到 代码 编写 
的 理论 和 实践 的 详细 讲解 。 对 于 那些 需要 实 操 指导 的 读者 来 说 ， 几乎 全 部 内 容 都 可 以 直接 应 用 在 
实际 敏捷 项 目的 管理 和 编码 活动 当中 。 如 果 你 是 一 名 初学 者 ， 可 以 在 本 书 中 学 习 到 使 用 C# 进行 
敏捷 开发 的 常见 模式 和 实践 ， 明 辨 其 优 劣 , 让 自己 走 在 正确 的 方向 上 , 为 后 续 的 能 力 提 升 打下 良 
好 的 基础 。 如 果 你 是 一 名 中 级 开发 人 员 ， 可 以 在 本 书 中 学 习 到 业界 的 最 佳 实践 ， 了 解 各 种 实践 组 
合 ， 对 SOLID 原则 获得 深入 的 理解 ， 并 完全 认识 到 其 在 实际 代码 开发 中 带 来 的 益 人 处。 如果 你 是 
一 名 高 级 开发 人 员 ， 毫 无 疑问 ， 你 将 获 益 最 多 。 本 书 提供 了 大 量 设计 模式 、SOLID 原则 、 单 元 测 
试 、 重 构 等 理论 的 示例 ， 将 理论 与 实践 关联 起 来 ， 让 你 可 以 直接 拿 来 应 用 于 工作 之 中 。 

当然 , 尽 信 书 不 如 无 书 ， 相 信 有 读者 会 对 书 中 所 讲 并 不 完全 赞同 , 但 表达 意见 的 前 提 是 首先 
要 理解 书 中 讲解 的 本 意 。 技 术 因 有 优 劣 ， 作 为 IT 技术 人 人员， 切忌 用 个 人 主观 情绪 来 表达 对 技术 
观点 的 不 满 。 我 有 时 会 听 到 周 于 有 人 说 :“ 我 就 是 看 着 不 更 !” 他 们 习惯 了 一 刀 切 ， 也 不 明白 一 名 
古话 :“ 三 人 行 ， 必 有 我 师 需 。” 原 书 作 者 Gary 已 经 在 全 书 技术 理论 和 实例 讲解 过 程 中 很 好 地 穿 
插 了 优 缺 点 和 应 用 场景 的 讨论 。 认 真 读 完 一 本 技术 书 的 收获 应 该 是 : 明 悉 技术 的 概念 和 原理 ， 了 
解 其 优 缺 点 ， 并 且 知 道 其 适用 场合 ;如 果 还 能 在 实践 中 针对 缺点 提出 改进 ， 那 就 再 好 不 过 了 。 


















































许 顺 强 
2016 年 3 月 21 日 
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本 书 英 文书 名 中 首先 提 到 的 一 个 关键 术语 是 自 适应 代码 (Adaptive Code )， 这 一 关键 术语 很 
好 地 诠释 了 应 用 本 书 中 介绍 的 基本 原则 能 够 达成 的 效果 : 无 需 大 量 返工 , 代码 即 可 自动 适应 后 续 
新 的 需求 和 无 法 预见 的 场景 。 本 书 旨 在 将 使 用 Microsoft .NET Framework 进行 C# 编 程 的 当前 最 佳 
实践 吉 括 于 一 卷 之 中 ,尽管 其 他 书 中 也 会 涵盖 本 书 中 的 某 些 内 容 , 但 这 些 书 要 人 么 偏重 于 讲解 理论 ， 
要 么 就 不 是 特定 于 .NET Framework 开发 的 。 

编写 代码 不 能 急于 求 成 。 与 阻碍 变化 的 代码 库 相 比 ， 如 果 你 的 代码 具有 自 适 应 能 力 ， 你 就 能 
够 更 加 快速 、 轻 松 地 对 其 进行 更 改 ， 并 且 不 会 引发 多 少 错误 。 相 信 大 家 都 知道 ， 对 于 需求 ， 不 变 
的 主题 就 是 变化 。 因 此 管理 需求 变更 是 软件 项 目 成 败 的 一 个 关键 因素 。 面 对 需求 变更 ， 开 发 人 员 
可 以 有 很 多 种 应 对 方法 , 这 些 方法 可 以 归 类 到 下 面 要 讲述 的 两 种 方法 论 。 这 两 种 方法 论 的 主旨 几 
乎 是 截然 相反 的 ， 特 别 是 在 变更 处 理 的 连续 性 上 。 

第 一 种 是 瀑布 方法 论 。 这 种 方法 论 要 求 开 发 人 员 必 须 遵 循 严 格 的 流程 。 应 用 这 种 方法 论 的 项 
目 中 ， 大 到 要 遵循 的 开发 流程 ， 小 到 要 实现 的 类 型 设计 都 很 不 灵活 ， 甚 至 几乎 与 50 年 前 用 穿孔 
卡片 进行 编程 开发 一 样 死 板 。 所 有 泽 布 方法 论 都 在 竭尽 全 力 确 保 软件 很 难 被 自由 更 改 。 软 件 开 发 
被 划分 为 分 析 、 设 计 、 实 现 和 测试 几 个 显著 不 同 的 阶段 ， 而 且 整 个 过 程 是 单 呵 的 。 一旦 进入 实现 
阶段 ， 用 户 就 很 难 去 变更 需求 ,或 者 说 至 少 要 付出 昂贵 的 代价 才能 变更 需求 。 当 然 , 代码 也 无 需 
为 需求 变更 作 任何 准备 ， 因 为 整个 瀑布 流程 几乎 不 提供 任何 其 他 选项 。 

第 二 种 是 敏捷 方法 论 。 它 不 仅仅 是 男 一 种 选择 ,而 且 是 对 尝 布 方法 论 的 一 种 彻底 推翻 。 敏 捷 
流程 的 主旨 就 是 拥抱 变化 , 它 被 看 作 是 客户 和 开发 者 之 间 的 一 个 必要 的 联系 纽带 。 如 果 客 户 想 要 
对 目 己 付费 的 产品 进行 某 些 改变 ,就 应 该 把 时 间 和 资金 的 代价 与 需求 的 变更 关联 起 来 ， 而 不 是 直 
接 把 变更 加 入 流程 中 正在 进行 的 阶段 。 软 件 工程 的 基础 是 源 代 码 ， 相 对 于 物理 工程 , 它 具 有 更 好 
的 可 塑性 。 建 造 一 座 房 子 的 过 程 就 是 使 用 水 泥 把 砖 逐 块 粘 合 在 一 起 , 所 以 改变 房子 设计 的 代价 就 
很 自然 地 与 房子 的 建造 完成 度 直 接 相 关 了 。 假 设 工程 尚未 开始 ， 只 有 设计 蓝图 , 那么 变更 设计 的 
代价 相对 来 说 就 会 很 低 。 如 果 已 经 装 好 了 窗户 ,， 布 好 了 电线 、 管 线 ， 此 时 再 想 把 楼 上 的 浴室 改 到 
楼 下 的 厨房 旁 ,， 那 代价 就 会 非常 高 了 。 软 件 产品 的 源 代 码 具 有 良好 的 可 塑性 ， 因 此 移动 特性 和 修 
改 用 户 界 面 的 导航 看 起 来 不 应 该 有 很 高 的 代价 , 但 不 季 的 是 ,事实 并 不 总 是 如 此 。 单单 时 间 成 本 
就 经 党 不 允许 在 软件 产品 中 进行 这 样 和 月 由 的 变更 。 在 我 看 来 , 这 主要 就 是 因为 代码 缺乏 对 需求 变 
更 的 自 适应 能 力 。 

本 书 将 通过 一 些 实际 的 例子 ， 为 大 家 演示 和 讲解 敏捷 流程 以 及 如 何 编 写 自 适应 代码 。 




































































2 前 言 


本 书面 向 的 读者 


本 书 的 意图 是 要 把 理论 与 实践 关联 起 来 。 如 果 你 是 经 验 丰富 的 高 级 开发 人 员 , 想 要 找 一 些 设 
计 模 式 、SOLID 原则 、 单 元 测试 、 重 构 等 理论 的 示例 ， 那 么 这 本 书 就 是 为 你 而 作 。 

如 果 你 是 具有 一 定 经 验 和 能 力 的 中 级 开发 人 员 , 想 要 学 习 业 界 的 最 佳 实 践 ， 了 解 它们 是 如 何 
配合 使 用 的 , 或 者 你 对 现在 的 业界 最 佳 实践 组 合 有 疑问 ,都 可 以 从 这 本 书 中 获 益 ， 因 为 现实 的 项 
目 开 发 中 很 难 找到 简单 且 容 易 理 解 的 实例 或 者 理论 。 开 发 人 员 对 大 多 数 SOLID 原则 已 经 有 所 了 
解 ,但 是 对 于 其 中 比较 复杂 的 开放 与 封 财 原则 (第 6 曹 ) 和 Liskov 替换 原则 (第 7 章 ) 的 理解 还 
不 够 充分 。 即 使 是 经 验 丰 富 的 开发 人 员 ， 有 时 也 无 法 完全 认识 到 依赖 注入 (第 9 章 ) 给 代码 开发 
市 来 的 好 人 处。 与 此 类 似 ， 接 口 (第 3 革 ) 能 给 代码 带 来 的 适 配 灵 活性 也 经 党 被 忽视 。 

如 采 你 是 刚刚 入 门 的 初级 开发 人 员 ,， 读 完 这 本 书 , 也 会 有 所 收获 。 你 可 以 学 习 到 常见 的 模式 
和 实践 ,并且 知道 哪些 方面 是 好 的 ,哪些 方面 从 长 期 来 看 是 不 好 的 。 我 见 到 的 软件 开发 实习 生 所 
写 的 代码 有 很 多 共同 点 ， 到 人 处 都 可 以 看 到 随从 反 模 式 (第 2 章 ) 和 服务 定位 带 反 模式 (第 9 音 ) 
的 代码 。 通常 , 实习 生 已 经 具备 了 很 多 方面 的 软件 开发 技能 , 要 把 他 变 成 一 个 重量 级 的 开发 人 员 ， 
只 需要 在 正确 的 方向 上 推 他 们 一 把 即 可 。 本 书 也 提供 了 多 种 可 选 的 实践 方案 , 并 对 其 优 缺 点 进行 
了 详细 解释 。 


阅读 本 书 的 前 提 条 件 

要 阅读 这 本 书 ， 你 应 该 具备 一 些 在 语法 上 与 C# 类 似 的 编程 语言 ( 比如 Java 或 C++ ) 的 实战 
经 验 ， 也 应 该 精通 条 件 分 支 、 循 环 和 表达 式 等 核心 过 程 编程 概念 。 此 外 ,还 应 该 有 使 用 类 进行 面 
向 对 象 开 发 的 经 验 ， 并 且 对 接口 的 概念 有 所 了 解 。 
本 书 不 适合 哪些 人 

如 果 你 刚刚 开始 学 习 编 程 开发 ,那么 本 书 并 不 适合 你 , 因为 书 中 涉及 一 些 高 级 开发 话题 , 需 
要 你 对 基本 的 编程 开发 概念 有 深入 的 理解 。 
本 书 结构 


本 书 共 分 为 三 个 部 分 ,每 一 部 分 都 以 上 个 部 分 为 基础 。 尽 管 如 此 , 也 可 以 从 任何 一 个 部 分 开 
台 阅 读本 书 。 每 个 音节 都 详细 讲解 了 一 个 完整 的 主题 ， 并 在 适当 的 地 方 包括 了 指向 其 他 章 方 的 交 
又 索引 。 


第 一 部 分 “敏捷 基础 


这 个 部 分 会 讲解 如 何以 自 适应 方式 开发 软件 的 基础 概念 ， 其 中 包括 业界 有 名 的 敏捷 流程 
Scrum， 该 流程 要 求 代码 具有 目 适 应 变更 的 能 力 。 这 一 部 分 的 所 有 章节 都 于 绕 接 口 、 设 计 模式 、 
























































重 构 和 单元 测试 进行 详细 的 讲解 。 

口 第 1 章 ” Scrum 介绍 
这 一 章 是 本 书 的 开篇 , 首先 介绍 一 种 业界 知名 的 敏捷 项 目 管理 方法 论 Scrum, 然后 详细 介 
绍 Scrum 项 目 中 相关 的 工件 、 角 色 、 度 量 标准 和 阶段 的 概念 ， 最 后 为 大 家 展示 如 何在 敏 
捷 环 境 下 组 织 资源 和 代码 。 

口 第 2 章 依赖 和 分 层 
这 一 章 将 引领 你 一 起 探索 依赖 和 架构 分 层 。 代 码 要 做 到 自 适 应 ， 前 提 是 解决 方案 的 结构 
允许 这 样 做。 首先 讲解 三 种 不 同类 型 的 依赖 : 第 一 方 、 第 三 方 和 框架 ; 然后 讲解 如 何 从 
反 模 式 ( 应 该 避免 的 ) 到 模式 (应 该 使 用 的 ) 来 管理 和 组 织 所 有 的 依赖 关系 ; 最 后 会 介 
绍 一 些 高 级 主题 供 你 进一步 阅读 ， 比 如 面向 切面 编程 和 非 对 称 分 层 等 。 

口 第 3 章 接口 和 设计 模式 
在 现代 .NET 应 用 的 开发 中 ， 接 口 几乎 无 处 不 在 ,但 是 它们 也 经 常 被 滥用 、 误 解 和 错 用 。 
这 一 章 将 首先 通过 一 些 常 见 和 实用 的 设计 模式 来 展示 接口 的 多 种 用 途 ; 然后 阐明 除了 使 
用 接口 进行 简单 的 抽象 外 ， 还 能 够 以 多 种 不 同 的 方式 使 用 接口 来 解决 同一 个 问题 。 如 果 
能 够 流利 地 使 用 开发 者 武器 库 中 的 混合 类 型 、 鸭 子 类 型 和 流 接口 ， 将 更 能 体会 到 接口 的 
强大 用 途 。 

口 第 4 章 单元 测试 和 重 构 
单元 测试 和 重 构 正 在 成 为 开发 人 员 必 备 的 两 个 实战 技能 ， 只 有 同时 应 用 这 两 个 技能 ， 才 
能 编写 出 自 适应 代码 。 没 有 完备 的 单元 测试 ， 重 构 动 作 肯 定 会 造成 很 多 错误 ; 没有 重 构 ， 
代码 则 会 变 得 腔 肿 、 伪 化 且 难 以 理解 。 这 一 章 会 从 一 个 十 分 简单 的 单元 测试 示例 开始 讲 
解 ， 然 后 扩展 讲解 更 高 级 、 实 用 的 模式 和 实践 ， 比 如 流 断 言 、 测 试 驱 动 开 发 和 模拟 。 本 
章 还 提供 了 真实 的 重 构 示 例 来 讲解 如 何 改 善 源 代码 的 可 读 性 和 可 维护 性 。 

















第 二 部 分 编写 SOLID 代码 


这 一 部 分 以 第 一 部 分 为 基础 ， 每 一 章 都 会 专门 讲解 SOLID 中 的 一 个 原则 。 这 些 音节 不 会 单 
单 讲 解 为 什么 要 使 用 这 些 原则 , 还 有 详细 的 实战 示例 来 讲解 如 何在 编码 实现 中 使 用 这 些 原 则 。 每 
一 章 都 会 提供 一 个 实际 项 目 中 的 例子 来 展示 SOLID 原则 的 作用 。 
口 第 5 章 单一 职责 原则 
这 一 章 会 为 开发 人 员 展 示 如 何 使 用 修饰 锅 和 适 配 需 模 式 来 实践 单一 职责 原则 。 应 用 这 个 
原则 后 ， 类 的 数目 会 增加 ， 但 是 每 个 类 的 规模 会 变 小 。 相 对 于 那些 功能 繁多 的 大 型 类 ， 
小 型 类 可 集中 解决 一 个 大 型 问题 中 的 一 小 部 分 。 聚 合 使 用 这 些小 型 类 会 比 使 用 单个 大 型 
类 更 强大 、 更 灵活 。 
口 第 6 章 开放 与 封闭 原则 
这 一 章 要 讲解 的 是 开放 与 封闭 原则 ， 它 的 概念 非常 简单 ， 但 是 它 对 代码 有 着 举足轻重 的 
影响 。 它 负责 确保 那些 遵守 所 有 SOLID 原则 的 代码 不 会 被 改动 ， 而 只 是 添加 新 代码 。 这 











4 前 言 


一 章 还 会 讨论 跟 开 放 与 封闭 原则 相关 的 可 预测 变化 的 概念 ， 并 且 会 探讨 它 如 何 能 够 识别 
后 续 自 适应 扩展 的 切入 点 。 

口 第 7 章 Liskov 替换 原则 
这 一 章 会 展示 在 代码 中 应 用 Liskov 替换 原则 所 带 来 的 好 处 ， 特 别 要 提 到 的 是 ，Liskov 替 
换 原 则 有 助 于 确保 开放 与 封闭 原则 的 应 用 ， 并 避免 代码 改动 所 带 来 的 副作用 。 这 一 章 还 
会 介绍 代码 契约 ， 它 包括 前 置 条 件 、 后 置 条 件 和 数据 不 变 式 三 个 要 素 ， 可 以 通过 代码 契 
约 工具 来 确保 代码 满足 它们 。 此 外 ， 这 一 章 还 描述 了 一 些 子 类 型 原则 ， 比 如 协 变 、 逆 变 
和 不 变性 原则 ， 并 介绍 了 违背 这 些 原则 会 带 来 的 不 良 影响 。 

口 第 8 章 接口 分 离 原则 
在 实际 的 代码 中 ， 接 口 和 类 的 问题 类 似 ， 它 们 的 规模 通常 太 过 庞大 。 接 口 分离 原 则 是 一 
个 经 常 被 忽视 却 简单 有 效 的 实践 原则 。 这 一 章 会 展示 将 接口 规模 限制 到 足够 小 ， 以 及 配 
合 使 用 这 些小 型 接口 能 够 带 来 的 好 处 。 此 外 还 会 探究 可 能 会 促使 接口 分 离 的 各 种 不 同 的 
原因 ， 比 如 客户 端 需求 和 架构 需求 。 

口 第 9 章 依赖 注入 原则 
这 一 章 的 核心 是 依赖 注入 ， 它 能 够 将 本 书 中 讲解 到 的 所 有 特性 结合 为 一 个 整体 。 依 赖 注 
和信 真 的 非常 重要 ， 没 有 它 ， 很 多 其 他 原则 都 无 法 起 作用 。 这 一 章 会 详细 介绍 依赖 注入 并 
比较 实现 依赖 注入 的 不 同方 法 。 这 一 章 还 会 讨论 如 何 使 用 控制 反 转 容器 来 管理 对 象 的 生 
命 周 期 ， 以 避免 服务 定位 器 等 反 模 式 ; 此 外 ， 还 会 讨论 如 何 识别 组 合 根 和 解析 根 。 


第 三 部 分 ” 自 适 应 实例 


这 一 部 分 以 一 个 示例 应 用 为 主线 , 将 本 书 的 剩余 内 容 组 织 到 一 起 。 尽 管 这 些 章节 中 有 
人 码 , 但 我 也 提供 了 很 丰富 的 注释 和 讲解 。 因 为 本 书 的 讲解 背景 是 敏捷 环境 ， 所 以 下 面 这 些 
按照 Scrum 的 冲刺 进行 组 织 ， 并 且 所 有 工作 都 是 由 积压 工作 项 和 客户 变更 请 求 而 来 。 
口 第 10 章 自 适应 实例 简介 
这 个 部 分 要 实际 开发 的 示例 应 用 是 一 个 基于 ASPNETMVC 5 开发 的 在 线 聊天 应 用 。 这 一 
章 会 先 详 细 描 述 这 个 应 用 ， 并 给 出 一 个 简要 的 设计 作为 后 续 架 构 的 指导 ， 最 后 还 给 出 了 
产品 积压 工作 上 所 有 特性 的 解释 。 
口 第 11 章 自 适 应 实例 冲刺 1 
这 一 章 介绍 如 何 使 用 测试 驱动 开发 方法 来 开发 示例 应 用 的 首要 特性 ， 包 括 查 看 和 创建 聊 
天 室 和 消息 。 
口 第 12 章 自 适 应 实例 冲刺 2 
这 一 章 讲解 客户 对 应 用 提出 需求 变更 ， 以 及 整个 开发 团队 如 何 通 过 自 适 应 代码 来 适应 这 
些 必然 会 发 生 的 变更 。 



































其 车 








附录 自 适 应 工具 


附录 简要 介绍 如 何 使 用 Git 源 代码 控制 从 GitHub 上 下 载 代码 ,以 及 如 何 使 用 Microsoft Visual 
Studio 2013 编译 下 载 的 代码 。 请 注意 ， 附 录 不 是 完整 的 Git 使 用 说 明 ， 你 可 以 在 网 上 找到 很 多 非 
第 详尽 的 资料 ， 比 如 Git 的 官方 教程 : http:/git-scm.com/docs/gittutorial。 

通过 快速 Web 搜索 可 以 找到 其 他 来 源 。 

附录 还 会 简要 介绍 其 他 的 一 些 开 发 工具 ， 比 如 持续 集成 和 开发 环境 。 


本 书 约定 


本 书 中 有 若干 反复 出 现 的 约定 用 法 , 你 可 以 在 微软 出 版 社 的 出 版 物 中 找到 标准 的 解释 , 我 也 
在 这 里 先 给 出 一 些 简要 的 解释 。 
代码 清单 

书 中 代码 清单 会 在 适当 的 地 方 出 现 , 相关 的 代码 会 在 同样 的 背景 块 中 。 比 如 下 面 的 代码 清单 
[1。 

代码 清单 上 1 这 是 一 个 代码 清单 ， 在 书 中 会 经 常 出 现 


public void MyService : IService 


{ 





} 


只 要 看 到 代码 清单 ， 你 都 应 该 关注 其 中 特定 的 一 部 分 代码 。 比 如 ， 当 对 上 一 份 示 例 代 码 进行 
改动 时 ， 与 改动 相关 的 代码 就 会 加 粗 显示 。 


阅读 辅助 和 补充 信息 


阅读 辅助 主要 提供 一 些 与 主题 相关 的 边栏 ， 比 如 注意 或 者 警告 ， 而 补充 信息 则 是 提供 一 些 更 
进一步 扩展 主题 的 信息 。 下 面 是 一 些 示 例 。 


注意 这 是 阅读 辅助 ， 其 中 包括 与 主要 内 容 相 关 的 小 信息 ， 不 过 具有 额外 的 重要 性 。 


这 是 补充 信息 


尽管 已 经 尽量 缩短 篇 幅 ， 但 是 补充 信息 通常 包含 与 主要 话题 不 太 相 关 的 较 长 讨论 。 


色 卢 


有 时 候 , 无 论文 字 解 释 有 多 人 么 形象 ,还 是 不 足以 表达 确切 的 含义 。 这 时 候 ， 就 必须 要 提供 图 
片 了 。 书 中 所 有 使 用 Microsoft Visio 2013 创建 的 图 表 都 是 黑白 色 的 , 目的 是 为 用 户 提 供 清 晰 的 说 
明 。 同 样 ， 截 图 也 是 在 高 对 比 度 主题 下 获取 的 。 


为 了 使 用 书 中 提供 的 代码 示例 ， 需 要 以 下 硬件 和 软件 。 

口 安装 了 以 下 任意 一 个 操作 系统 : Windows XP SP3( Starter Edition 除外 )、 Windows Vista SP2 
( Starter Edition 除外 )、Windows 7、Windows Server 2003 SP2、Windows Server 2003 R2、 
Windows Server 2008 SP2 以 及 Windows Server 2008 R2。 

口 安装 了 Visual Studio 2013 的 任意 版 本 ( 如 果 你 使 用 的 是 Express Edition 系列 产品 , 可 能 需 
要 下 载 几 个 安 疙 包 )。 

口 安装 了 Microsoft SQL Server 2008 Express Edition 或 者 更 高 版 本 ( 2008 或 R2 版 本 )， 以 及 
SQL Server Management Studio 2008 Express 或 更 高 版 本 ( Visual Studio 安装 包 中 已 经 包括 ， 
Express Edition 则 需要 单独 下 载 )。 

口 处 理 器 频率 不 低 于 1.6 GHz (推荐 2 GHz )。 

D 内 存 大 小 不 低 于 1GB (32 位 操作 系统 ) 或 2GB (64 位 操作 系统 )。 如 果 运 行 虚拟 机 系统 
或 者 使 用 SQL Server Express 版 本 ， 则 另外 需要 512 MB 内 存 ， 更 高 的 SQL Server 版 本 需 
要 更 多 内 存 。 

D 便 盘 可 用 空间 不 低 于 3.5 GB。 

口 硬盘 转速 不 低 于 每 秒 5400 转 。 

口 显卡 必须 支持 DirectX 9， 并 且 文 持 1024x768 或 者 更 高 分 辨 率 的 显示 。 

口 DVD 光驱 ( 如 果 需 要 从 DVD 安装 Visual Studio )。 

口 能 够 连接 互联 网 以 便 下 载 软件 或 者 代码 示例 。 

基于 不 同 的 Windows 配置 ， 你 可 能 需要 本 地 管理 员 权 限 才能 安装 或 配置 Visual Studio 2013 

和 SQL Server 2008 等 产品 。 


下 载 示 例 代 码 


我 会 尽力 保证 书 中 的 代码 片段 都 是 一 个 可 独立 运行 的 应 用 或 者 单元 测试 中 的 一 部 分 。 我 使 用 
MSTest 写 了 很 多 简单 的 单元 测试 ， 因 此 无 需 使 用 其 他 额外 的 测试 器 ， 另 外 我 也 使 用 NUnit 写 了 
一 些 更 复杂 的 单元 测试 。 我 使 用 Visual Studio 2013 Ultimate 编写 了 书 中 所 有 的 代码 。 尽 管 一 些 代 
码 是 用 Visual Studio 2013 Ultimate 预览 版 编写 的 ， 但 是 它们 都 能 够 使 用 正式 版 成 功 编译 和 测试 。 
我 尽量 不 使 用 Visual Studio 2013 Express 版 本 之 外 的 特性 ， 但 是 有 些 主题 的 代码 必须 使 用 ， 因 此 
你 可 能 需要 安装 一 个 付费 版 本 来 运行 部 分 代码 。 

















代码 可 以 从 GitHub 下 载 ， 网 址 是 : http://aka.ms/AdaptiveCode CodeSamples。 
附录 包含 了 Git 的 使 用 方法 简介 。 
我 很 乐意 看 到 你 的 留言 ， 下 面 是 我 的 WordPress 博客 网 址 : http://garymcleanhall. 


WwWordpress.com。 
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勘误 、 更 新 和 相关 支持 


我 们 已 经 尽 了 最 大 的 努力 来 确保 书 中 内 容 以 及 相关 材料 是 正确 的 ,你 可 以 从 下 面 的 网 址 得 到 
本 书 的 更 新 ， 其 中 包括 完整 的 勘误 表 : http://aka.ms/Adaptive/errata。 

如 果 你 发 现 了 勘误 表 之 外 的 新 错误 或 者 不 当 之 处 ， 也 请 在 上 面 的 网 址 提交 。 

如 果 你 需要 额外 的 文 持 ， 可 以 发 送 电 子 邮件 给 微软 出 版 社 文 持 中 心 : mspinput@microsoft. 
como。 

此 外 ， 有 关 微 软 软件 或 者 人 硬件 产品 的 支持 不 能 通过 上 面 的 网 址 获得 ， 请 访问 以 下 网 址 : 


http://support.microsoft.com。 


微软 出 版 社 的 免费 电子 书 


微软 出 版 社 有 很 多 免费 的 电子 书 ， 深 入 讲述 了 很 多 技术 主题 。 这 些 电 子 书 以 PDF、EPUB 和 
Mobi (Kindle 电子 书 阅 读 需 文 持 的 格式 ) 等 格式 供 读者 下 载 : http:/aka.ms/mspressfree。 
党 去 看 看 ， 你 会 发 现 很 多 新 的 电子 书 。 


期 每 你 的 反馈 


在 微软 出 版 社 看 来 , 读者 的 满意 度 始 终 是 第 一 位 的 , 读者 的 反馈 是 最 有 价值 的 资产 。 请 在 下 
面 的 网 址 将 你 对 这 本 书 的 看 法 提交 给 我 们 : http://aka.ms/tellpress。 
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我 们 知道 大 家 都 很 低 , 所 以 尽量 只 设计 了 少量 的 简单 问题 。 大 家 的 回答 会 被 直接 发 送 给 微软 
出 版 社 的 编辑 〈 不 需要 个 人 信息 ) 谢谢 大 家 的 热心 反馈 。 


保持 联系 
让 我 们 保持 联系 ， 下 面 是 我 们 的 Twitter 网 址 : http://twitter.com/MicrosoftPress。 
电子 书 


扫描 如 下 二 维 码 ， 即 可 购 闫 本 书 电子 版 。 
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这 一 部 分 主要 介绍 敏捷 原则 和 实践 的 基础 知识 。 

编写 代码 是 软件 开发 的 核心 工作 ， 而 编写 好 用 的 代码 有 很 多 不 同 的 方式 。 即 使 抛 开平 台 、 
语言 和 框 染 的 影响 ， 对 于 一 个 开发 人 员 ， 最 简单 的 一 个 功能 的 实现 也 会 有 多 种 选择 。 

在 软件 开发 产业 ， 开 发 成 功 的 软件 产品 一 直 以 来 都 古 焦点 。 但 是 近 儿 年 ， 开 发 人 员 开 始 重 
视 那 些 能 够 被 重用 并 能 提高 代码 质量 的 实现 模式 和 实践 ， 因 为 大 家 逐渐 意识 到 软件 产品 的 质量 
是 无 法 与 代码 的 质量 割裂 开 来 的 。 随 着 时 间 的 推移 ， 质 量 差 的 代码 会 逐渐 降低 产品 的 质量 ， 至 
少 一 定 会 延迟 可 工作 软件 的 完整 交付 。 

为 了 开发 高 质量 的 软件 产品 ， 开 发 人 员 必 须 努 力 确保 编写 的 代码 征 可 维护 的 、 可 读 的 ， 并 
且 是 经 过 测试 的 。 在 此 基础 上 ， 对 开发 人 员 提出 了 一 个 新 的 要 求 : 编写 的 代码 也 应 该 具备 一 定 
的 自 适 应 变更 的 能 力 。 











这 一 部 分 的 四 个 人 章 广 主要 介绍 现代 的 软件 开发 流程 和 实践 。 这 些 流程 和 实践 有 一 个 统一 的 
类 型 名 称 ， 那 就 是 敏捷 ， 以 表达 它们 具有 快速 啊 应 变更 和 改变 方向 的 能 力 。 敏 捷 流 程 (Agile 
Process) 给 软件 开发 团队 推荐 了 很 多 的 方法 ， 用 于 快速 得 到 反馈 、 啊 应 并 调整 工作 焦点 。 敏 捷 
实践 (Agile Practice) 还 推荐 了 很 多 方法 来 帮助 开发 团队 编写 出 自 适 应 代码 。 


Scrum 介 绍 





完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 给 项 目的 主要 干系 人 分 配角 色 。 

口 识别 Serum 需要 生成 的 各 种 文档 和 其 他 工件 。 

口 监测 Scrum 项 目 进度 。 

口 诊断 Scrum 项 目的 问题 并 提出 补救 措施 。 

口 高 效 主持 Scrum 会 议 以 达成 最 大 的 会 议 成 果 。 

口 对 比 Scrum 和 其 他 敏捷 或 严 奇 方法 之 间 的 优 劣 。 

Scrum 是 一 个 具体 的 项 目 管 理 方法 论 。 更 准确 地 说 ， 它 是 敏捷 方法 的 一 种 。Scrum 的 核心 概 
念 是 以 迭代 的 方式 为 软件 产品 增加 价值 。 整 个 Scruam 流 程 是 可 重复 的 ， 也 可 以 迭代 多 次 ， 一直 持 
续 到 整个 产品 完成 或 者 流程 被 终止 。 这 些 迭 代 被 称 为 冲刺 ( sprint )。 经 过 奉 干 个 冲刺 得 到 的 软件 
是 随时 可 以 发 布 的 。 整 个 软件 产品 的 所 有 工作 项 都 会 在 产品 积压 工作 ( product backlog ) 上 按照 
优先 级 排列 , 在 每 个 冲刺 开始 时 , 开发 团队 会 把 在 这 个 新 的 冲刺 中 承诺 要 完成 的 工作 项 添加 到 冲 
刺 积 压 工作 ( sprint backlog ) 上 。Scrum 中 工作 项 的 单位 是 故事 ( story )。 产 品 积压 工作 实际 上 就 
是 一 个 排 好 序 的 候选 故事 队列 ,每 个 冲刺 则 由 要 在 这 一 个 冲刺 中 承诺 要 开发 完成 的 故事 组 成 。 图 
1-1 展 示 了 Scrum 流 程 的 框架 。 

Scrum 过 程 中 ， 开 发 团队 内 部 或 外 部 相关 角色 人 员 会 产 出 一 些 文档 工件 ， 此 外 他 们 还 会 一 起 
参加 一 些 会 议 。 只 用 一 童 的 篇 幅 当 然 无 法 从 项 目 管理 的 角度 完整 展示 整个 Scrum 的 细节 ， 但 是 本 
章 会 尽量 提供 足够 多 的 细节 ， 为 你 进一步 深入 学 习 Scrum 打 下 基础 ， 并 为 后 续 的 每 日 实践 提供 一 
个 方 回 性 的 指导 。 
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日 常 
工作 
产品 积 庄 工 作 冲刺 积压 工作 冲刺 发 布 
产品 积压 工作 包含 承诺 要 完成 的 故事 会 每 个 冲刺 的 周期 大 概 每 个 冲刺 结束 后 ,已 
了 要 实现 的 特性 和 被 放 进 冲刺 积压 工作 为 1 周到 4 周 。 种 刺 过 经 实现 的 新 增 特性 就 
故事 中 ， 故 事 的 选择 都 按 程 中 ， 整 个 团队 的 目 会 在 产品 的 新 版 本 中 
照 故 事 在 积压 工作 中 标 始终 是 努力 完成 所 发 布 
的 优先 级 顺序 进行 有 承诺 要 完成 的 故事 


图 1-1 Scrum 的 工作 方式 看 起 来 就 像 一 条 为 软件 产品 逐步 添加 小 特性 的 生产 线 


Scrum 是 一 种 敏捷 方法 
敏捷 方法 论 (Agile ) 包括 一 组 轻 量 级 软件 开发 方法 ， 它 们 都 允许 及 时 响应 客户 的 需求 ， 
即使 项 目 已 经 在 进行 过 程 中 了 。 敏捷 是 在 很 多 严 敬 的 结构 化 项 目 实践 失败 的 教训 中 应 运 而 生 
的 。 敏捷 宣言 列 出 了 敏捷 和 严 苟 方法论 之 间 详 细 的 对 比 项 。 大 家 可 以 在 以 下 网 址 查看 完整 的 
敏捷 宣言 : http:/www.agilemanifesto.org。 
敏捷 宣言 最 初 只 是 由 十 七 位 开发 人 员 联 名 发 起 的 。 但 是 从 那 一 刻 起 , 敏捷 方法 的 影响 力 
就 在 日 益 扩 展 ， 现 在 已 经 成 为 了 敏捷 大 环境 下 各 个 软件 开发 角色 公认 的 基本 约定 。Scrum 是 
目前 敏捷 方法 论 中 应 用 最 广泛 、 最 常见 的 一 个 流程 实现 。 


1.1 Scrum 与 瀑布 


根据 我 多 年 的 软件 产品 开发 经 验 , 敏捷 方法 比 瀑布 方法 工作 的 效果 要 好 ,而 且 我 也 乐于 推广 
各 种 敏捷 流程 。 瀑 布 方法 论 的 根本 问题 在 于 它 过 于 严 柯 和 伪 化 。 图 1-2 展 示 了 一 个 瀑布 工程 涉及 
的 流程 阶段 。 

从 图 1-2 可 以 看 到 ， 每 个 阶段 的 输出 都 是 下 一 个 阶段 的 输入 ， 而 且 每 个 阶段 必须 在 进入 下 一 
个 阶段 前 完成 。 这 就 要 求 在 一 个 阶段 完成 时 没有 遗留 任何 错误 、 问 题 、 难 点 或 者 误解 ， 因 为 整个 
过 程 只 是 单 向 的 。 

瀑布 流程 还 要 求 在 任 一 阶段 完成 后 不 允许 再 发 生 任何 更 改 , 而 这 与 大 量 的 经 验 和 统计 数据 不 
符 。 变 化 本 号 就 是 生活 固有 的 一 部 分 ， 软 件 工程 也 不 例外 。 溪 布 方法 文 持 的 这 种 应 对 变更 的 僵硬 














1.1 Scrum 与 瀑布 $ 


态度 是 高 代价 的 、 不 值得 的 ， 而 且 是 肯定 可 以 避免 的 。 瀑 布 方法 论 认定 可 以 花费 更 多 时 间 在 需求 
和 设计 阶段 来 识别 出 所 有 潜在 的 变更 ， 这 样 在 后 续 阶段 就 不 会 发 生变 更 了 。 这 个 观点 很 不 靠 谱 ， 
因为 变更 总 会 发 生 ， 不 论 你 愿意 与 否 。 








图 1-2 ”瀑布 开发 流程 
为 了 应 对 变更 , 敏捷 流程 引入 了 另外 一 种 方法 , 这 个 方法 主动 拥抱 变化 并 且 人 允许 每 个 人 都 能 





快速 啊 应 任何 变更 。 尽 管 敏捷 ( 包括 Scrum ) 提供 了 流程 级 别 上 的 变更 啊 应 机 制 ， 但 是 在 现代 软 
件 开 发 的 信条 里 ,要 在 代码 级 别 啊 应 变更 是 最 困难 的 ，, 也 是 最 重要 的 。 本 书 的 宗旨 就 是 竭力 为 你 
展示 如 何 编写 出 能 够 灵活 地 目 适 应 变更 的 代码 。 

妨 外 , 瀑布 方法 论 是 以 文档 为 核心 的 ,会 产 出 大 量 的 文档 ， 而 这 些 文档 并 不 能 直接 改善 软件 
产品 。 敏 捷 则 恰恰 相反 ,， 它 认为 能 工作 的 软件 就 是 这 个 软件 产品 最 重要 的 文档 。 些 竞 真 正 的 软件 
行为 是 由 软件 源 代码 定义 的 ， 而 不 是 由 与 代码 相关 的 文档 决定 的 。 此 外 ,瀑布 方法 论 的 文档 和 代 
码 是 完全 分 开 的 ， 所 以 很 容易 就 会 出 现 文档 没有 与 代码 完全 同步 的 情况 。 

Scrum 设 置 了 一 些 度量 标准 ， 用 于 反映 项 目 进度 和 整体 健康 状况 ， 这 些 标准 与 产品 的 说 明 性 
文档 是 不 同 的 。 总 体 而 言 ， 敏 捷 倾 向 于 有 适量 的 文档 以 避免 规避 责任 的 现象 , 但 是 它 也 不 强制 要 
求 必须 撰写 这 些 文档 。 如 果 这 些 文档 不 是 撰写 一 次 就 再 也 不 会 被 查阅 的 话 , 那么 有 些 代码 肯定 能 
从 这 些 文 持 文档 中 获 益 。 出 于 这 个 原因 ， 易 用 的 在 线 文档 〈 比如 Wiki ) 就 成 为 了 Scrum 团 队 很 稼 
用 的 工具 。 

本 草 的 剩余 部 分 将 会 更 深入 地 讨论 Scrum 中 最 重要 的 方面 ， 其 中 讨论 的 不 完全 是 Scrum， 也 
有 与 Scrum 相 关 的 篆 见 变 体 。Scrum 流 程 的 目标 不 仅仅 是 通过 迭代 的 方式 改进 软件 产品 ， 而 且 也 
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包括 改进 开发 流程 。 在 Scrum 团 队 特 有 的 状况 和 上 下 文中 ，Scrum 流 程 囊 励 团 队 持 续 人 微调 来 保证 
整个 流程 对 所 有 成 员 来 说 是 合适 的 。 

本 章 在 讨论 过 Scrum 的 基本 构成 后 ， 还 会 指出 它 的 一 些 缺 陷 。 这 一 章 是 本 书 的 基础 ， 由 于 
Scrum 流 程 承 详 拥 抱 变 更 , 后续 章节 就 会 在 此 基础 上 详细 讲解 如 何 编写 出 能 够 自 适 应 变更 的 代码 。 
一 个 声称 自己 可 以 优雅 地 处 理 变更 但 很 难 在 代码 层次 实现 的 流程 是 没有 意义 的 。 








Scrum 的 不 同形 态 

任何 时 候 ， 当 一 个 开发 团队 声明 他 们 遵循 了 Scrum 方 法 时 ， 通 常 是 说 他 们 自己 遵循 了 
Scrum 的 某 种 变 体 ( variant )。 纯 正 的 Scrum 并 不 包含 很 多 常见 的 实践 活动 ， 它 们 来 源 于 诸如 
极限 编程 ( eXtreme Programming，XP ) 等 其 他 的 一 些 敏捷 方法 。Scrum 有 三 个 分 支 ， 它 们 的 
实现 都 逐渐 偏离 了 纯粹 的 Scrum 理 论 。 

增强 的 Scrum 

Scrum 并 不 包含 一 些 常见 的 实践 活动 ， 比 如 测试 先行 以 及 结对 编程 。 但 是 对 于 很 多 团队 
而 言 , 这 些 实践 活动 是 对 Scrum 流 程 本 身 很 好 的 补充 , 因此 它们 被 认为 是 有 辅助 作用 的 实践 。 
当 团 队 从 其 他 敏捷 方法 (比如 极限 编程 或 者 看 板 ) 引入 一 些 实践 活动 时 候 ， 实 际 操作 的 流程 
应 该 被 称 为 增强 的 Scrum。 这 意味 着 ，Scrum 和 一 些 优秀 实践 活动 的 组 合 起 到 增强 而 非洲 弱 
标准 Scrum 流 程 的 作用 。 

弱化 的 Scrum 

一 些 开 发 团队 声称 他 们 正在 实践 Scrum， 但 是 却 忽 略 了 一 些 关键 点 。 他 们 在 产品 积压 工 
作 上 按照 优先 级 顺序 排列 了 工作 项 ， 在 Sprint 冲刺 中 选择 了 要 完成 的 工作 项 ， 而 且 有 追溯 会 
议 以 及 每 日 站 立会 议 。 但 是 ， 他 们 并 没有 按照 故事 点 估算 故事 ， 而 是 采用 真正 的 时 间 估 算 。 
这 种 Scrum 流 程 的 变 体 被 称 为 弱化 的 Scrum。 这 种 情况 下 ， 国 队 尽 管 在 很 多 方面 应 用 Scrum 定 
义 的 实践 活动 ， 但 是 实际 上 却 忽视 了 几 个 关键 的 活动 。 

根本 不 是 Scrum 

如 果 一 个 开发 团队 的 实践 严重 偏离 了 Scrum 方 法 ， 他 们 实际 上 就 不 是 在 使 用 Scrum。 这 
一 定 会 在 开发 过 程 中 引起 问题 , 特别 是 当 团队 成 员 希 望 能 应 用 一 种 敏捷 方法 而 实际 的 流程 却 
一 点 都 不 像 Scrum 流 程 时 。 我 发 现 每 日 站 立会 议 是 最 容易 被 开发 团队 采纳 的 Scrum 实 践 活动 ， 
但 是 让 团队 成 员 在 心中 对 变更 进行 相对 估算 并 且 积极 拥抱 变更 却 很 难 。 当 很 多 Scrum 流 程 的 
实践 活动 被 团队 放弃 后 ， 实 际 运行 的 流程 就 根本 不 是 Scrum 了。 


1.2 角色 和 职责 


Scrum 仪 仅 是 个 流程 ,我 要 反复 强调 的 是 ， 只 有 团队 成 员 都 遵循 流程 它 才 会 起 作用 。 不 同 角 
色 的 人 有 痢 不 同 的 职责 ， 不 同 的 职责 则 需要 采取 不 同 的 行动 。 





1.2 角色 和 职责 


1.2.1 产品 负责 人 








产品 负责 人 (Product Owner，PO ) 的 角色 在 Scrum 中 非常 重要 ， 因 为 产品 负责 人 是 Scrum 团 
队 和 客户 之 间 唯 一 的 联系 。 产 品 负 责 人 要 对 最 终 产 品 负责 ， 他 们 负 有 以 下 相应 的 责任 。 


D 决定 要 构建 哪些 特性 。 

口 根据 业务 价值 设 定 特 性 的 优先 级 。 

口 接受 或 者 拒绝 “已 完成 ”工作 。 

作为 项 目 成 功 的 关键 干系 人 , 产品 负责 人 必须 时 刻 准 备 着 为 团队 服务 ,给 他 们 清晰 呈现 项 目 
的 愿景 。 所 有 开发 团队 成 员 都 应 该 清楚 地 知道 项 目的 长 期 目标 ， 而 且 都 能 够 及 时 清楚 地 了 解 到 变 
更 的 详细 信息 ,在 制定 短期 冲刺 计划 时 ,产品 负责 人 应 首先 安排 好 要 开发 什么 以 及 什么 时 候 开 始 。 
EO 并 且 在 产品 积压 工作 中 对 这 些 特性 设 定 优先 级 。 

尽管 产品 负责 人 是 个 关键 角色 ， 但 是 这 并 不 意味 着 产品 负责 人 在 整个 Scrum 流 程 中 的 影响 不 
受 约束 。 产品 负责 人 不 能 决定 开发 团队 一 个 冲刺 内 需要 完成 的 工作 量 , 因为 这 是 由 开发 团队 上 自 号 
的 开发 速度 决定 的 。 同样， 产品 负责 人 不 能 决定 如 何 实现 工作 项 ， 、 队 会 从 技术 层面 上 
决定 一 个 故事 的 详细 实现 方案 。 当 然 ， 产品 负责 人 不 能 改动 冲刺 目标 ,改变 验 
收 标 准 , 或 者 增删 故事 。 经 过 冲刺 计划 会 会 议 ， 此 时 处 于 运行 状态 的 
冲刺 就 是 不 可 更 改 的 了 ,任何 改动 都 必须 等 到 下 一 个 冲刺 ,除非 明确 中 止 当 前 冲刺 或 者 整个 项 目 ， 
然后 重新 开始 。 冲 刺 的 这 种 不 可 破坏 性 保证 了 开发 团队 能 够 在 整个 冲刺 进行 过 程 中 心 无 劳 区 地 朝 
着 既定 的 目标 努力 。 

整个 冲刺 期 间 ,无论 故事 在 进行 中 还 是 已 经 完成 , 产品 人 负 环 Boe 常 去 试用 进行 中 的 产品 ， 

看 看 特性 的 状态 如 何 , 或 者 给 正在 进行 的 任务 提 提 意见 。 产 品 负责 人 多 花 点 时 间 与 开发 团队 保持 
紧密 的 沟通 是 很 重要 的 , 这 样 才 可 以 及 时 应 对 那些 突然 出 现 人 意外 和 混乱 . 到 冲刺 结束 时 ， 产 品 
负责 人 不 能 简单 地 接受 那些 声明 - 圣 完成 ”但 却 偏离 了 初始 目标 的 故事 ,而 是 应 该 通过 制定 好 
的 验收 标准 来 检验 一 个 故事 是 否 已 经 完成 以 及 是 否 可 以 展示 。 
























































1.2.2” ”Scrum 主管 


Scrum 主 管 ( Scrum Master，SM ) 负责 在 冲刺 进行 过 程 中 为 团队 隔离 所 有 外 部 影响 ， 并 且 处 
理 团 队 成 员 在 每 日 站 立会 议 上 提 到 的 各 种 影响 开发 的 障碍 。 这 样 才 可 以 保证 在 冲刺 期 间 , 整个 开 
发 团队 能 够 高 效 地 朝 着 当前 的 既定 目标 努力 。 

产品 负责 人 要 对 做 出 怎样 的 产品 负责 ，Scrum 主 管 则 要 对 如 何 完 成 产品 的 流程 负责 。 因 此 ， 
Scrum 主 管 的 职责 就 是 确保 整个 团队 按照 既定 的 流程 来 完成 既定 的 产品 目标 。Scrum 主 管 能 够 主 
守 对 流程 的 改进 ( 比如 把 冲刺 周期 从 四 周 绚 短 到 两 周 ), 但 是 他 们 的 权限 也 是 有 限 的 。 比 如 Scrum 

主管 只 可 以 指导 开发 团队 按照 Scrum 流 程 开 发 ， 而 不 可 以 越 租 代 应 地 指定 开发 团队 如 何 实现 一 个 
故事 。 

作为 流程 负责 人 ，Scrum 主 管 要 负责 组 织 每 日 站 立会 议 ， 他 们 要 确保 所 有 开发 团队 成 员 都 出 
席 会 议 ， 并 且 记 录 会 议 纪 要 以 防 遗 漏 某 些 行动 项 。 不过， 这 并 不 代表 着 团队 成 员 要 在 会 议 上 给 
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Scrum 主 管 做 工作 汇报 ， 每 个 成 员 参 加 站 立会 议 的 真正 意图 是 为 了 让 所 有 与 会 者 都 能 大 概 了 解 到 
自己 的 工作 项 进度 和 状况 。 


1.2.3 ”开发 团队 


理想 情况 下 ， 一 个 敏捷 团队 由 一 些 全 科 专 家 ( generalizing specialist ) 组 成 。 也 就 是 说 ， 团 队 
的 每 个 成 员 应 该 能 够 熟练 使 用 多 个 领域 的 技术 ， 而 且 精 通 或 特别 擅长 其 中 的 某 个 领域 。 比 如 说 ， 
在 一 个 由 四 名 开发 人 员 组 成 的 敏捷 团队 中 ， 每 个 开发 人 员 都 能 胜任 所 有 与 ASPNET 、MVC、 
Windows Workflow 以 及 Windows Communication Foundation ( WCF ) 相关 的 工作 项 ; 但 是 其 中 两 
个 开发 人 员 特 别 擅长 Windows Forms ， 另 外 两 人 则 喜欢 使 用 Windows Presentation Foundation 
( WPF ) 和 Microsoft SQL Server。 

队 中 开发 人 员 的 技能 重合 能 够 防止 团队 中 出 现 简 仓 现象 。 简 仓 现象 的 表现 是 , 团队 中 的 各 
种 专家 ( 比如 网 页 开发 专家 、 数 据 库 专 家 或 WPF 专 家 等 ) 各 自 掌 握 了 产品 开发 必需 的 一 种 知识 。 
Scrum 中 ， 代 码 是 由 开发 团队 集体 挂 有 的 ， 而 这 种 简 仓 现象 会 妨碍 全 体 开发 人 员 的 参与 度 。 因 此 
在 组 建 团队 的 时 候 , 应 该 尽 可 能 避免 出 现 这 种 简 仓 现象 。 此 外 ， 简 仓 也 不 利于 业务 的 开展 ， 因 为 
业务 的 某 个 领域 会 过 度 依 赖 单个 “专家 ”开发 人 员 的 能 力 ， 而且 这 些 “ 专 家 ”开发 人 员 顶 着 “他 
们 是 唯一 能 完成 这 些 工 作 项 的 人 ”的 大 帽子 ， 压 力也 会 非常 大 。 

软件 测试 人 员 人 负责 保 证 所 开发 软件 的 质量 。 在 开始 实现 一 个 故事 前 , 测试 人 员 可 能 需要 规划 
自动 化 测试 以 保证 故事 的 实现 符合 各 种 预先 定义 的 验收 标准 。 他 们 要 么 与 开发 人 员 一 起 制定 计 
划 ， 要 么 单独 完成 。 当 开发 人 员 完 成 一 个 故事 时 ， 就 会 提交 故事 的 实现 以 供 测试 ， 然 后 测试 分 析 
人 员 会 核实 软件 产品 是 否 按照 要 求 的 那样 正常 工作 。 




















124 “和 和 “ 鸡 ?” 


Scrum 流 程 中 的 所 有 角色 都 可 以 划分 为 两 类 :“ 猪 ”和 “ 鸡 ”。 这 种 形象 的 比喻 来 源 于 下 面 的 
故事 。 有 一 天 ， 鸡 对 它 的 好 朋友 猪 阅 :“ 猪 路 ， 我 有 个 很 棒 的 想法 ,我 们 应 该 开 个 饭店 !” 猪 也 党 
得 主意 不 错 ， 很 兴奋 地 问 鸡 :“ 那 我 们 给 它 起 个 啥 名 呢 ? ” 鸡 说 :“ 要 不 就 叫 “火腿 和 鸡蛋” 吧 ! 
猪 想 了 一 下 就 发 了， 说 道 :“ 门 都 没有 ， 你 只 是 下 下 恒 ， 我 却 要 制 肉 ! 

这 个 寓言 故事 很 好 笑 ， 用 在 这 里 只 是 用 来 强调 一 个 项 目 中 的 不 同 角 色 有 着 不同 的 参与 度 。 
“ 猪 ”需要 全 里 心 投入 到 项 目 中 ， 并且 要 对 它们 的 产 出 负责 ; 而 “ 鸡 ” 只 是 有 所 页 献 ， 不 会 深入 
参与 到 项 目 中 。 产 品 负责 人 、Scrum 主 管 和 开发 团队 扮演 的 都 是 “ 猪 ” 的 角色 ， 因 为 他 们 都 需要 
全 刁 心 致力 于 产品 的 交付 。 通 常 , 客户 不 需要 深入 产品 开发 中 , 因此 他 们 扮演 的 是 “ 鸡 ” 的 角色 。 
类 似 地 ， 因 为 执行 管理 层 的 支持 工作 是 针对 项 目 本 里 的 ， 而 不 是 产品 ， 所 以 也 应 该 是 “ 鸡 ” 而 不 
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1.3 工件 


在 所 有 软件 项 目的 生命 周期 内 都 会 创建 、 评 审 和 分 解 细 化 很 多 的 文档 、 图 表 和 度量 标准 。 从 
这 个 角度 看 ， 一 个 Scrum 项 目 也 会 有 同样 的 工件 。 然 而 ，Scrum 文 档 与 其 他 类 型 项 目 管理 的 文档 
有 着 不 同 的 目的 和 类 型 ,所 有 敏捷 流程 和 严 苛 流程 之 间 的 一 个 关键 区 别 , 就 在 于 文档 的 重要 性 上 。 
比如 , 结构 化 系统 分 析 和 设计 方法 ( Structured Systems Analysis and Design Methodology, SSADM ) 
就 特别 强调 需要 撰写 很 多 的 文档 。 这 也 被 笑称 为 “大 设计 优先 ”( Big Design Up Front，BDUF ) 
理论 ,这 种 理论 相信 ， 如 果 能 够 花 足 够 多 的 时 间 和 人 力 资 源 来 撰写 文档 ， 所 有 的 您 届 、 不 确定 性 
和 怀疑 就 可 以 从 项 目 中 清除 。 敏捷 流程 则 致力 于 减少 文档 的 数量 , 只 保留 那些 对 于 项 目 成 功 至 关 
重要 的 文档 。 此 外 ,敏捷 流程 更 看 重 代 码 而 非 文 档 ， 因 为 代码 本 里 作为 最 具有 权威 性 的 文档 ,是 
随时 可 以 部 署 、 运 行 和 使 用 的 。 敏捷 流程 还 倾 呵 于 所 有 干系 人 都 直接 沟通 ,而 不 是 写 一 些 很 少 有 
人 看 的 文档 。 总 而 言 之 , 文档 对 于 敏捷 项 目 依 然 是 重要 的 , 但 是 它 不 能 取代 可 工作 的 软件 和 沟通 
本 刁 。 








1.3.1 _Scrum 面板 


Scrum 项 目 日 常 工 作 的 中 心 区 域 是 Scruam 面 板 。 应 该 为 面板 保留 几 面 墙 的 空间 ， 太 小 的 面板 
将 没有 空间 展示 重要 的 细节 。 也 许 专门 为 此 在 办 公 室 建 足 够 大 的 墙 面 代价 会 比较 大 , 但 你 也 可 以 
采用 其 他 的 一 些 性 价 比较 高 的 办 法 。 比 如 可 以 重新 利用 那些 经 党 被 人 忽视 的 、 比 较 大 的 白板 作为 
Scrum 面 板 ， 再 加 上 磁铁 和 金属 填充 格 ， 就 更 像 一 个 Scrum 面 板 了 。 如 果 办 公 室 是 租 来 的 ， 或 者 
因 某 种 原因 不 能 损坏 墙壁 ,还 可 以 使 用 “神奇 的 ”白板 ， 即 白 纸 ， 因 为 它 方便 简洁 且 无 需 擦 除 内 
容 。 一 定 要 尝试 在 办 公 室 找 一 块 合适 的 地 方 放 置 Scruam 面 板 ， 无 论 选 择 了 什么 样 的 面板 ， 也 无 论 
如 何 放置 它 ， 如 果 在 使 用 了 几 个 冲刺 后 ， 感 觉 不 合适 ， 可 以 随时 改变 它 。 对 于 Scrum 流 程 而 言 ， 
Scrum 面 板 实物 是 必 备 的 ， 其 他 的 工具 (比如 数字 化 面板 等 ) 永远 无 法 给 你 那 种 站 在 实际 面板 前 
的 体验 和 感觉 。 尽 管 数 字 化 面板 也 有 它们 的 用 途 ， 但 我 仍然 相信 它们 只 是 辅助 工具 。 图 1-3 展 示 
了 一 个 典型 的 Scrum 面 板 。 
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图 1-3 一 个 Serum 面板 ， 展 示 了 当前 的 开发 状态 


Scrum 面 板 是 项 日 信息 的 聚集 地 , 包括 了 很 多 细节 , 并 能 展现 出 正在 进行 的 工作 项 的 重要 性 。 
下 面 几 节 会 全 面 详 细 地 介绍 Scrum 面 板 的 使 用 。 

1. 卡片 

Scrum 面 板 上 的 主要 物品 就 是 卡片 。 卡 片 会 用 来 展示 软件 产品 进度 的 不 同 元 素 ， 从 软件 的 发 
布 到 最 细小 的 独立 任务 .为 了 清晰 起 见 , 不 同类 型 的 卡片 应 该 有 不 同 的 颜色 .因为 空间 限制 ,Scrum 
面板 通常 只 用 来 展示 与 当前 冲刺 相关 的 故事 、 人 任务、 缺陷 以 及 技术 债务 (technical debt )。 





提示 “单独 使 用 颜色 来 区 分 可 能 无 法 满足 每 位 团队 成 员 的 需求 。 比 如 ， 对 于 那些 无 法 分 状 


颜色 的 团队 成 员 而 言 ， 可 以 辅助 使 用 不 同 的 形状 来 作 卡 片 类 型 的 区 分 。 





@ 组 成 的 层次 结构 

图 1-4 展 示 了 Scrum 面 板 上 不 同类 型 卡片 的 层次 关系 。 请 注意 , 这 里 的 前 提 是 产品 是 由 很 多 个 
任务 组 成 的 。 即 使 是 最 复杂 的 软件 也 可 以 分 解 成 为 有 限 的 大 干 个 独立 任务 , 要 完成 整个 软件 ， 就 
必须 先 完成 这 些 任务 。 
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图 1-4 ”Scrum 面 板 上 的 不 同类 型 的 卡 片 展示 了 组 成 产品 的 不 同 元 系 以 及 它们 之 间 的 层 
次 关系 


@ 产品 

Scrum 食 物 链 的 顶端 是 要 构建 的 软件 产品 。 软 件 产品 的 例子 很 多 : 集成 开发 环境 (IDE )、 网 
络 应 用 程序 、 会 计 软件 、 社 交 媒 体 应 用 程序 等 。 你 要 开发 的 是 软件 ， 要 交付 的 是 产品 。 

通常 每 个 开发 团队 每 次 只 开发 一 个 产品 , 但 是 有 时 候 单个 团队 也 可 能 会 同时 为 交付 多 个 产品 
负责 。 

e@ 发 布 

每 个 要 开发 的 产品 都 会 有 多 个 发 布 。 一 个 发 布 就 是 一 个 特定 版 本 的 软件 , 用 户 可 以 购买 软件 
或 者 使 用 该 软件 提供 的 服务 。 有 的 发 布 只 是 为 了 解决 耕 干 缺陷 ,， 有 的 发 布 则 会 为 关键 用 户 提 供 有 
价值 的 新 特性 ， 还 有 的 发 布 只 是 提供 测试 版 本 来 让 用 户 尝 鲜 和 反馈 。 

网 络 应 用 程序 通常 只 会 在 所 有 发 布 前 部 署 一 次 ， 版 本 变更 也 不 会 很 明显 。 实 际 上 ，Google 
Chrome 网 络 浏览 器 就 是 个 很 有 意思 的 范例 。 尽 管 它 是 一 个 果 面 应 用 ,但 是 它 的 每 次 发 布 都 很 小 ， 
对 用 户 而 言 几 乎 没有 感觉 ， 这 与 其 他 浏览 右 的 高 调 发 布 方式 截然 相反 。 像 Internet Explorer 8、9 
和 10 分 别 都 有 自己 的 广告 投放 , 而 Chrome 则 没有 选择 这 样 的 发 布 模式 , Google 只 是 简单 地 为 浏览 
器 本 和 做 推广 , 推广 的 时 候 也 不 会 提 及 版 本 。 而 这 种 迭代 式 的 发 布 方式 也 变 得 越 来 越 流行 。Scrum 
在 每 个 冲刺 后 能 够 很 自然 地 通过 专注 于 交付 可 工作 的 软件 来 支持 这 种 发 布 模式 。 
































最 小 可 行 发 布 
第 一 个 发 布 可 以 是 一 个 最 小 可 行 发 布 (Minimum Viable Release，MVR )， 它 包括 了 能 名 
满足 用 户 最 基本 需求 的 一 组 特性 。 比 如 ， 对 于 会 计 软 件 ， 最 基本 的 特性 集合 包括 : 创建 新 客 
户 , 客户 账户 上 的 存 取 交 易 以 及 账户 金额 汇总 。 了 最 小 可 行 发 布 的 核心 目的 就 是 引导 项 目 尽早 
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做 到 自 筹资 金 并 继续 发 展 。 尽管 最 小 可 行 发 布 的 结果 不 太 可 能 就 达到 自 筹资 金 这 个 目标 , 但 
是 至 少 通过 这 种 发 布 可 以 提前 获得 一 些 回报 来 抵消 部 分 开发 成 本 。 此 外 ,即使 最 小 可 行 发 布 
的 目标 客户 范围 受 限 , 它 的 部 署 也 能 够 获得 宝贵 的 用 户 反馈 ,或 许 还 会 影响 到 后 续 该 软件 发 
展 的 方向 。 这 种 及 时 调整 方向 的 能 力也 是 Scrum ( 以 及 其 他 敏捷 方法 ) 自身 与 生 俱 来 的 ， 因 
为 这 些 敏 捷 方法 都 认为 软件 不 断 进化 的 前 提 就 是 软件 必须 要 变化 。 


无 论 发 布 的 日 的 和 方式 (或 者 频率 ) 如 何 ， 理 想 情 况 下 ， 单 个 产品 的 生命 周期 内 都 会 包含 多 
Me 

e@ 特性 

每 个 发 布 由 上 一 个 发 布 的 软件 没有 的 耕 干 个 新 特性 组 成 。 任 何 软 件 的 版 本 1.0 和 版 本 2.0 的 最 
显著 的 区 别 就 是 那些 团队 成 员 认 为 能 够 吸引 新 老 用 户 购 买 软件 或 者 升级 包 的 新 特性 。 

最 小 可 售 特性 ( Minimum Marketable Feature，MME ) 这 个 术语 可 以 用 来 界定 一 个 发 布 需要 
的 特性 集合 。 下 面 列 出 了 一 些 示 例 特性 ， 这些 特性 非常 通用 ,可 以 应 用 于 许多 不 同 的 项 目 ， 同 时 
也 非常 特定 ， 它 们 就 是 真实 世界 的 特性 。 

口 以 可 移植 的 XML 格 式 导出 数据 

口 需要 在 0.5 秒 内 响应 网 页 请 求 

口 保存 数据 以 备 后 续 使 用 

口 复制 和 粘贴 文本 

口 与 同事 在 网 络 上 共享 文件 

特性 如 果 能 给 客户 带 来 价值 , 那么 它 就 是 可 以 出 售 的 。 在 尽量 提炼 出 最 小 功能 集合 的 同时 依 
然 能 保持 其 具有 可 交付 的 价值 ， 此 时 得 到 的 特性 的 粒度 也 是 最 小 的 。 


史诗 /特性 、 最 小 可 和 售 特性 与 主题 
当 谈 论 Scrum 的 时 候 ， 可 能 更 经 常 使 用 的 术语 是 史诗 (epic ) 而 不 是 特性 (feature )， 我 
个 人 不 太 经 常 使 用 前 者 。 史 诗 和 特性 通常 被 看 作 “ 大 型 的 故事 ”， 也 就 是 说 ， 这 些 故 事 比 最 
小 可 售 特性 大 很 多 ， 因 此 无 法 在 一 个 单独 的 冲刺 后 交付 。 
特性 也 与 Scrum 的 另外 一 个 术语 主题 (theme ) 类 似 ， 主 题 是 指 一 组 有 着 共同 目标 的 
故事 。 


对 每 个 发 布 而 言 , 可 以 将 特性 划分 为 三 类 : 必需 的 、 可 选 的 和 想 要 的 。 这 三 个 分 类 是 互 斥 的 ， 
用 于 反映 每 个 特性 的 优先 级 。 通 带 ， 开 发 团队 必须 首先 完成 所 有 必需 的 特性 ， 然 后 才 是 可 选 的 特 
性 ， 此外， 只 有 在 时 间 允 许 的 情况 下 才 可 以 触及 想 要 的 特性 。 你 也 许 已 经 猪 到 ， 这些 分 类 和 特性 
本 号 总 是 可 变 的 。 当 团队 想 要 切换 工作 焦点 的 时 候 ( 当然 ,这 会 附带 引起 计划 和 经 费 的 改变 )， 
可 以 在 任意 时 间 中 止 它们 、 对 其 重新 排序 、 交 换 其 顺序 以 及 废弃 它们 。Scrum 中 的 一 切 部 是 不 确 
定 的 ， 而 本 书 就 是 致力 于 帮助 你 学 会 应 对 这 些 不 确定 性 。 
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@ 用 户 故 事 

用 户 故 事 可 能 是 绝 大 多 数 开 发 人 员 最 熟悉 的 Scrum 工 件 ， 但 实际 上 它 根本 不 是 由 Scrum 定 义 
和 提出 的 。 用 户 故 事 最 先是 极限 编程 方法 定义 的 工件 ， 因 为 它 在 软件 开发 领域 变 得 很 常用 ， 因 此 
Scrum 方 法 后 来 也 引入 了 它 。 用 户 故 事 需 要 通过 下 面 的 模板 来 声明 。 

“作为 [ 某 个 用 户 角色 ] ， 我 想 要 | 做 菜 种 行为 ] ， 以 便于 [ 给 这 个 用 户 角色 带 来 

某 种 价值 ] 。” 

上 面 模板 中 , 方 括号 中 的 内 容 会 因 具 体 用 户 故 事 而 有 所 不 同 。 下面 举 个 具体 的 例子 来 作 进 一 
步 的 解释 。 

“作为 一 个 注册 但 未 经 验证 的 用 户 ， 我 想 要 重 置 我 的 密码 ， 以 便于 当 我 忘记 密码 的 

时 候 还 能 够 再 次 登录 系统 。” 

这 个 用 户 故 事 描述 示例 包含 了 很 多 值得 注意 的 地 方 。 首先 , 这 个 故事 并 不 包含 足够 的 信息 来 
实现 必需 的 行为 。 特 别 要 注意 的 是 , 用户 故 事 是 从 用 户 的 角度 出 发 编写 的 。 尺 管 这 一 点 看 起 来 很 
明显 , 但 实际 上 很 多 人 都 忽略 了 这 一 点 ,很 多 故事 都 是 错误 地 从 开发 人 员 的 角度 编写 的 。 这 就 是 
为 什么 用 户 故 事 模板 中 的 第 一 部 分 “作为 [ 某 个 用 户 角色 了 至 关 重 要 的 原因 。 类 似 地 ， 第 三 部 
分 “以 便于 [| 给 这 个 用 户 角 色 带 来 某 种 价值 了 也 同等 重要 ， 因 为 如 果 没 有 它 ， 那 么 这 个 故事 存 
在 的 根本 原因 就 会 被 忽略 挥 。 通常 这 部 分 也 表达 了 用 户 故 事 与 父 特性 之 间 的 联系 ; 上 面 这 个 用 户 
故事 示例 可 能 属于 诸如 “被 忘记 的 凭据 是 可 恢复 的 ”这 样 的 特性 。 也 很 可 能 与 “用 户 忘 记 了 登录 
名 ”以 及 “用 户 忘 记 了 登录 名 和 密码 ”这 两 个 用 户 故 事 归 属于 同一 主题 。 

既然 并 不 能 单单 从 用 户 故 事 开 始 开 发 工作 , 那么 它 的 价值 何在 ? 用 户 故 事 代表 了 开发 团队 与 
客户 之 间 的 对 话 。 当 需要 实现 某 个 用 户 故 事 时 ,开发 人 员 会 之 着 故事 与 客户 讨论 具体 的 需求 ,并 
且 会 产生 出 在 整个 用 户 故 事 的 生命 周期 内 都 必需 遵守 的 若干 个 验收 标准 , 仅 可 以 将 完全 符合 了 所 
有 验收 标准 的 用 户 故 事 标注 为 已 完成 。 

当 需 求 收集 完 之 后 , 开发 人 员 就 需要 开始 准备 一 些 设计 来 满足 这 些 需 求 。 这 个 阶段 可 能 需要 
使 用 Balsamiq、Microsoft Visio 或 者 其 他 一 些 工 具 来 制作 用 户 界 面 的 模型 。 通常 使 用 统一 建 模 语 言 
( Unified Modeling Language，UML ) 图 表 来 从 技术 角度 上 详细 表达 如 何 改 动 现 有 代码 以 满足 这 些 
新 的 需求 。 

当 设 计 确 定 后 , 团队 就 可 以 开始 将 用 户 故 事 分 解 为 小 的 任务 , 然后 通过 完成 这 些 任务 来 实现 
整个 故事 。 当 开发 人 员 认 为 故事 的 实现 已 经 满足 要 求 了 , 那么 他 们 就 可 以 交付 故事 实现 以 进行 验 
收 测试 。 最 后 的 质量 保证 ( quality assurance，QA ) 阶段 会 再 次 根据 验收 标准 来 对 可 工作 的 软件 
进行 测试 验收 ， 并 决定 批准 或 者 驶 回 该 故事 的 实现 。 如 果 用 户 故事 的 实现 得 到 了 批准 ,那么 才 真 




































































正 完 成 了 这 个 用 户 故事 。 
让 我 们 花 点 时 间 来 回顾 一 下 前 面 讲述 的 要 点 。 以 一 个 用 户 故 事 为 依据 , 开发 人 员 在 分 析 阶 段 
收集 需求 ， 然 后 准备 好 设计 方案 ,接着 做 具体 实现 ， 最 后 按照 验收 标准 做 测试 。 这 听 起 来 就 像 是 


一 个 瀑布 开发 方法 的 过 程 。 这 的 确 是 用 户 故 事 的 要 点 , 为 每 个 用 户 故 事 执行 一 壳 小 规模 的 但 完整 
的 软件 开发 生命 周期 。 这 种 方式 有 助 于 防止 出 现 无 用 功 ， 因 为 在 没有 分 解 和 实现 用 户 故 事 之 前 ， 








大 大 本 


14 第 1 草 Scrum 介绍 





开发 人 员 不 需要 做 什么 ， 但 是 他 们 一 直 知 道 用 户 故 事 依旧 符合 软件 产品 的 价值 主题 。 

用 户 故 事 是 Scrum 过 程 中 最 主要 的 工作 重心 ; Scrum 流 程 是 通过 使 用 用 户 故 事 的 故事 点 数 来 
激励 团队 成 员 的 。 在 冲刺 计划 会 议 上 , 团队 一 起 给 每 个 故事 估算 故事 点 数 ， 当 团队 完成 了 某 个 用 
户 故 事 时 , 就 认为 团队 已 经 挣 取 了 它 的 故事 点 数 , 并 可 以 从 整个 冲刺 的 总 点 数 中 扣除 该 故事 的 所 
有 点 数 了 。 后 面 的 章节 会 进一步 详细 讲解 故事 点 数 的 概念 和 应 用 。 

@ 任务 

任务 是 比 用 户 故 事 还 要 小 的 工作 项 。 可 以 把 一 个 用 户 故 事 分 解 成 多 个 容易 管理 的 任务 ,然后 
分 配给 多 个 开发 人 员 并 行 开 发 。 我 倾向 于 在 准备 实现 故事 时 再 开始 做 任务 分 解 , 但 是 也 有 很 多 人 
会 在 冲刺 的 计划 会 议 时 就 完成 了 所 有 承诺 要 完成 的 故事 的 任务 分 解 。 

尽管 用 户 故 事 是 在 功能 角度 上 的 完整 竖 切 , 但 是 分 解 得 到 的 任务 依然 可 以 分 层 , 这 样 就 可 以 
充分 利用 团队 成 员 的 技术 特长 。 比 如 说 ,要 给 一 个 数据 表 增 加 一 个 新 的 数据 项 ， 这 很 可 能 需要 改 
动用 户 界 面 、 业 务 逻 辑 以 及 数据 访问 层 实现 。 团 队 可 以 将 这 个 故事 分 解 成 三 个 任务 ,它们 分 别针 
对 分 解 得 到 的 三 层 需求 并 指派 给 三 个 各 有 特长 的 开发 人 员 : WPF 高 手 、C# 能 手 以 及 数据 库 大 咖 。 
当然 ， 如 果 团 队 成 员 全 都 是 全 能 技术 能 手 , 任何 人 都 可 以 在 任何 时 间 胜 任 任何 任务 ,那么 你 就 太 
幸运 了 。 这 种 分 层 分 解 任务 的 方式 可 以 让 每 个 团队 成 员 拥 有 很 广 的 选择 任务 范围 , 也 有 助 于 他 们 
理解 整个 项 目 并 有 更 高 的 满意 度 。 














竖 切 

在 我 小 的 时 候 ， 管 和 爸 每 年 圣诞 节 都 会 做 蛋 奶 层 营 蛋糕 。 这 是 一 种 传统 的 多 层 英国 甜点 。 
最 下 面 是 水 果 块 屋 ， 然 后 是 松 糕 层 、 果 普 层 和 牛奶 沙 司 层 , 最 上 面 是 奶油 层 。 我 哥哥 喜欢 用 
勺子 一 直 从 上 朝 下 吃 ， 而 我 则 喜欢 换 着 吃 不 同 的 层 。 

好 的 软件 设计 就 像 层 登 蛋 糕 一 样 分 层 。 最 下 面 是 数据 访问 层 ， 然 后 是 对 人 象 关 系 映射 层 、 
域 模 型 层 、 服 务 层 和 控制 屋 ， 最 上 面 是 用 户 界 面 层 。 与 吃 层 营 蛋 糕 一 样 ， 开 发 这 种 分 层 软件 
也 有 两 种 方式 : 横 切 和 竖 切 。 

如 果 选 择 横 切 方式 ,每 层 都 需要 作为 一 个 整体 来 实现 ,但 是 这 样 不 能 保证 每 层 的 实现 都 
协调 同步 。 用 户 界 面 也 许 已 经 可 以 允许 用 户 去 交互 完成 某 些 特性 ,但 是 下 面 的 功能 层 还 没有 
实现 。 实 际 的 结果 就 是 用 户 必 须要 等 待 所 有 层 都 配合 完成 这 个 功能 后 才 可 以 使 用 这 个 应 用 。 
这 会 导致 无 法 及 时 得 到 用 户 的 反馈 ， 并 且 会 增加 做 无 用 功 或 者 做 错 的 可 能 性 。 

在 敏捷 流程 里 ， 应 该 选择 坚 切 方式 。 每 个 用 户 故 事 应 该 由 每 层 上 的 功能 组 合 而 成 ， 并 且 与 
最 上 层 的 用 户 界面 联系 起 来 。 这 样 才 可 以 完整 演示 某 个 功能 来 获取 用 户 的 及 时 反馈 。 这 种 方式 
也 可 以 避免 从 程序 员 角 度 撰 写 用 户 故 事 ， 比 如 “我 想 能 查询 数据 库 以 知道 那些 本 月 没有 缴费 的 
用 户 清单 ”这 种 描述 听 起 来 像 个 任务 ; 而 正确 的 故事 描述 应 该 是 “生成 未 付费 账户 的 报告 清单 ”。 








请 注意 ， 只 有 用 户 故 事 才 持 有 故事 点 数 , 用 户 故 事 分 解 得 到 的 任务 并 不 能 继承 和 持 有 故事 点 
数 。 可 以 说 五 个 故事 点 数 的 用 户 故事 被 分 解 为 三 个 独立 的 任务 , 但 是 不 可 以 说 两 个 一 点 的 任务 和 
一 个 三 点 的 任务 组 成 了 五 个 点 数 的 用 户 故 事 。 这 是 因为 完成 单独 的 任务 并 不 会 获得 故事 集 点 数 的 
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激励 。 只 有 当 测 试 人 员 和 产品 负责 人 在 冲刺 结束 前 确认 整个 用 户 故 事 已 经 完成 了 才 可 以 获取 该 故 
事 的 所 有 用 户 点 数 。 如 果 没 有 完成 或 只 是 部 分 完成 , 整个 用 户 故 事 的 故事 点 数 依然 不 能 从 冲刺 故 
事 点 数 中 扣除 。 理 想 情 况 下 ， 用 户 故 事 会 在 一 个 冲刺 内 完成 ， 如 果 没 有 完成 ， 应 该 在 下 一 个 冲刺 
继续 。 如 果 一 个 故事 因 耗 时 太 长 而 无 法 在 一 个 单独 的 冲刺 内 完成 , 那 说 明 这 个 用 户 故 事 的 粒度 太 
大 ， 应 该 分 解 为 多 个 更 小 、 更 容易 管理 的 故事 。 

@ 技术 债务 

技术 债务 是 个 很 有 意思 的 概念 , 但 是 它 也 很 容易 被 误解 。 它 是 个 隐喻 ， 用 于 描述 在 一 个 用 户 
故事 生命 周期 内 在 架构 设计 和 实现 上 所 做 的 折 中 和 妥协 。 本 章 后 面 专 门 有 一 节 讲 解 技术 债务 。 

e 缺陷 

如 果 某 些 完 成 的 用 户 故 事 没有 符合 某 些 验收 标准 ,就 需要 创建 缺陷 卡片 了 。 这 就 要 求 有 上 自动 
化 的 验收 测试 : 针对 某 个 用 户 故 事 撰 写 的 一 组 测试 就 形成 了 一 个 回归 测试 套件 , 可 以 用 于 保证 后 
续 的 工作 不 会 破坏 已 通过 验收 的 用 户 故 事 的 实现 。 

与 技术 债务 一 样 , 缺陷 卡片 也 不 会 持 有 故事 点 数 ， 因 此 修复 缺陷 和 技术 债务 带 来 的 问题 并 不 
会 获得 故事 点 数 激励 。 虽 然 做 到 零 缺 了 哆 和 零 债 务 很 不 现实 , 但 是 开发 人 员 应 该 尽 最 大 努力 去 避免 
引入 缺陷 和 技术 债务 。 

所 有 软件 都 有 缺陷 , 这 是 软件 开发 无 法 逃避 的 事实 , 缺乏 计划 或 不 勤勉 并 不 是 人 会 犯错 误 的 
根本 原因 ,缺陷 通常 会 被 划分 为 三 大 类 :灾难 缺陷 ( Apocalyptic defect ), 行 为 错误 ( Behavioral error ) 
和 外 观 上 的 问题 ( Cosmetic issue ); 按照 首 字母 也 被 称 为 A、B 、C 三 类 。 

灾难 缺陷 会 直接 导致 应 用 程序 的 彻底 骨 溃 或 者 导致 用 户 的 操作 无 法 继续 。 未 捕获 异 浓 是 一 个 
典型 的 例子 , 因为 此 时 应 用 必须 先 强制 结束 然后 再 次 启动 , 或 者 是 必须 重新 加 载 一 次 网 络 场景 
的 网 页 。 这 些 缺 陷 应 该 具有 最 高 优先 级 ， 并 且 必 须 在 软件 发 布 前 修复 好 。 

行为 错误 不 像 灾难 缺陷 那样 严重 但 是 也 会 令 用 户 不 满 。 这 种 类 型 的 错误 还 有 可 能 比 直 接 让 应 
用 程序 骨 溃 更 有 破坏 性 。 试 想 一 下 , 如 果 错 误 的 货币 转换 逻辑 把 账户 资金 数额 的 小 数 部 分 给 弄 没 
了 ， 无 论 算法 的 错误 是 对 用 户 还 是 业务 有 害 ， 有 人 终归 是 要 为 这 样 的 行为 错误 承担 资金 损失 的 。 
当然 , 不 是 所 有 的 逻辑 错误 都 会 这 么 严重 , 但 是 这 个 例子 有 助 于 让 我 们 明白 , 行为 错误 可 以 是 中 
优先 级 ， 也 可 以 是 高 优先 级 。 

界面 问题 通常 是 和 用 户 界面 相关 的 问题 ,比如 图 片 未 对 齐 , 窗口 无 法 全 屏 , 或 者 网 页 上 某 个 图 
片 无 法 加 载 显 示 等 。 这 些 问题 不 影响 软件 的 使 用 ， 只 是 影响 它 的 外 观 。 尽 管 这 种 问题 通常 只 是 低 优 
先 级 的 , 但 是 它们 也 很 重要 ,因为 界面 的 表现 也 是 用 户 对 软件 的 期 望 之 一 。 如 果 用 户 界面 上 的 按钮 
无 法 使 用 , 图 片 无 法 加 载 显示 , 用 户 也 自然 无 法 相信 软件 的 内 部 行为 会 正常 工作 。 相 反 地 ,一 个 花 
里 胡 哨 的 用 户 界面 也 会 让 用 户 感到 这 个 软件 并 不 是 针对 公众 发 布 的 ,信誉 不 好 的 项 目 通 常 需要 重新 
设计 用 户 界 面 ( 甚至 可 能 改变 产品 品牌 羔 改 善 市 场 对 该 产品 的 看 法 以 及 重 设 用 户 对 该 产品 的 期 望 。 













































































让 卡片 意图 更 明确 
有 很 多 种 办 法 可 以 自 定义 以 及 个 性 化 Scrum 面 板 上 的 卡片 。 
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颜色 主题 

在 卡片 上 应 用 任何 颜色 主题 都 可 以 ， 不 过 按照 我 的 经 验 ,， 其 中 一 些 比较 合理 。 特 性 和 用 
户 故 事 可 以 使 用 索引 卡 〈index card ), 任务、 缺陷 和 技术 债务 可 以 使 用 即时 贴 ( sticky note )， 
因为 可 以 很 方便 地 把 它们 贴 在 相关 故事 附近 。 下 面 是 我 推荐 的 使 用 方式 。 

口 特 性 : 绿色 的 索引 卡 

口 用 户 故 事 : 白色 的 索引 卡 

口 任务 : 黄色 的 即时 贴 

口 缺陷 : 红色 或 粉色 的 即时 贴 

口 技术 债务 : 紫色 或 蓝 色 的 即时 贴 

注意 ， 作 为 使 用 卡片 最 多 的 用 户 故 事 和 任务 ， 它 们 应 该 使 用 最 常见 可 用 的 索引 卡 和 即时 
贴 。 此 外 为 了 避免 索引 卡 不 够 用 ， 请 尽量 使 用 最 常见 且 可 用 的 颜色 。 

谁 来 创建 卡片 ? 

这 个 问题 的 答案 很 简单 直接 ， 那 就 是 “任何 人 ”。 当 然 ， 在 实际 应 用 中 也 会 有 些 条 件 。 
虽然 任何 人 都 可 以 创建 一 个 卡片 ， 但 是 该 卡片 的 有 效 性 、 优 先 级 、 严 重 程度 以 及 其 他 一 些 状 
态 值 并 不 能 只 由 创建 者 单独 决定 。 所 有 的 特性 和 用 户 故 事 卡 片 必 须 由 产品 负责 人 最 终 核 实 ， 
而 任务 、 缺 陷 和 技术 债务 卡片 则 只 应 该 由 开发 团队 来 核实 。 

头像 

类 似 于 网 上 论坛 、 博 客 和 Twitter 上 的 用 户头 像 ,团队 的 每 个 成 员 也 要 有 个 自己 的 小 画像 。 
让 团队 成 员 自己 选择 自己 的 头像 ， 这 也 是 Scrum 流 程 中 比较 有 趣 的 一 个 过 程 。 当 然 ， 需 要 引 
导 团 队 成 员 不 要 选择 有 冒犯 性 的 头像 ， 只 要 保证 最 终 每 个 人 的 头像 是 有 区 别 的 就 可 以 。 

在 迭代 过 程 中 ， 这 些 头 像 会 被 移动 好 多 次 ， 通 常 是 每 天 移动 一 次 。 因 为 Scrum 面 板 上 已 
经 贴 满 了 故事 索引 卡 和 任务 即时 贴 , 因 此 这 些 头像 不 应 该 大 于 两 二 照片。 使 用 薄板 履 压 图 像 ， 
可 以 防止 其 出 现 折 角 和 破损 ， 还 可 以 用 小 片 胶 带 把 头像 固定 在 一 个 地 方 。 


2. 泳 道 

在 Scrum 面 板 上 ， 通 过 多 个 垂直 线 划 分 出 了 多 条 泳 道 。 每 条 泳 道 可 以 包含 多 个 用 户 故 事 卡 以 
表示 相关 故事 在 其 开发 生命 周期 内 的 进度 。 典 型 的 排列 是 从 左 到 右 的 四 条 泳 道 : 积压 工作 、 开 发 、 
验收 和 完成 。 

积压 工作 泳 道中 的 故事 是 开发 团队 已 经 承诺 在 当前 冲刺 要 进行 开发 的 , 所 以 它们 述 时 会 被 移 
动 到 开发 泳 道 中 ,除非 它们 在 开发 前 被 中 止 了 。 这 条 泳 道 内 的 故事 卡 可 以 按照 优先 级 排列 ， 这 样 
最 上 面 的 卡片 总 是 包含 下 一 个 要 实现 的 故事 。 

从 积压 工作 泳 道中 取出 故事 后 ， 首 先 要 先 和 产品 负责 人 沟通 以 确定 该 故事 的 范围 和 需求 ， 然 
后 分 解 为 多 个 独立 的 任务 ， 最 后 把 该 故事 和 分 解 它 得 到 的 多 个 任务 一 起 放 进 开发 泳 道中 。 此 时 ， 
所 有 参与 开发 该 故事 的 团队 成 员 的 小 头像 也 应 该 贴 在 故事 卡 周 围 了 ,不 同 的 泳 道 会 有 不 同 的 限制 。 
比如 ， 你 也 许 要 求 最 多 同步 开发 三 个 故事 ， 这 样 才 可 以 强迫 团队 优先 完成 已 经 开始 的 故事 ， 而 不 
是 再 从 积压 工作 泳 道中 取出 新 的 故事 。 请 切记 : 没有 完全 完成 的 故事 无 法 挣 取 该 故事 的 任何 点 数 。 
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当 一 个 故事 经 过 分 析 、 设 计 和 实现 后 ， 它 会 被 标记 为 “已 经 完成 开发 ”的 状态 ， 此 时 就 可 以 
把 它 移动 到 验证 泳 道中 了 。 理 想 情 况 下 ， 验 证 环境 应 该 和 产品 环境 尽 可 能 地 一 致 ， 以 避免 后 期 部 
署 时 因为 环境 的 些许 不 同 而 发 生 错误 。 测 试 分 析 人 员 使 用 验收 标准 来 评 佑 故事。 本 质 上 讲 ， 他 们 
要 做 的 是 尽量 破坏 故事 以 证 明代 码 无 法 按照 预期 正常 工作 。 通常 , 测试 人 员 通 过 给 某 些 操作 输入 
边界 和 错误 数据 ,来 验证 操作 代码 的 验证 逻辑 是 否 工作 正常 ,测试 人 员 甚 至 会 尝试 找 出 安全 漏洞 ， 
以 确保 可 疑 终端 用 户 无 法 获取 额外 的 高 级 别 权 限 。 测 试验 证 通过 之 后 , 所 有 和 该 故事 相关 的 故事 
点 数 就 可 以 从 当前 冲刺 的 总 故事 点 数 上 扣除 了 ,同时 冲刺 燃 尽 网 ( 展示 冲刺 进度 的 图 表 ) 也 可 以 
进行 更 新 了 。 这 些 工 件 将 在 后 面 详细 讲解 。 

@ 水 平 泳 道 

Scrum 面 板 还 可 以 通过 水 平 泳 道 来 做 进一步 的 划分 。 团 队 可 以 使 用 水 平 泳 道 按 照 特性 来 给 故 
事 分 组 ， 这 样 团队 所 有 人 一 眼 就 能 看 得 出 当前 正在 攻关 哪里 ， 也 能 知道 需要 缓解 哪些 瓶颈 。 

在 面板 顶部 有 个 特殊 的 泳 道 称 为 快速 泳 道 , 可 以 把 所 有 优先 级 非常 高 的 任务 放 在 这 条 水 平 泳 
道 。 通 过 指定 多 名 团队 成 员 集 中 在 快速 泳 道上 的 工作 项 , 来 尽快 完成 这 些 高 优先 级 的 任务 ; 但 同 
时 ,这 也 会 对 其 他 未 完成 的 任务 产生 不 好 的 影响 。 集 体 攻 坚 可 以 确保 团队 停 下 手 上 的 工作 ， 以 集 
中 力量 协同 解决 一 个 最 高 优先 级 的 问题 或 者 任务 。 这 个 办法 对 这 种 出 现 最 高 优先 级 问题 的 场景 很 
有 用 ， 但 是 也 应 该 慎 用 。 人 快速 泳 道中 最 常见 的 工作 项 就 是 在 已 经 发 布 的 产品 中 发 现 的 灾难 缺陷 。 

3. 技术 债务 

技术 债务 这 个 概念 值得 做 进一步 的 解释 。 在 实现 一 个 故事 的 过 程 中 , 很 有 可 能 需要 在 “最 优 
代码 ”和 “足够 好 的 代码 ” 间 做 出 一 些 折 中 以 确保 不 错过 最 后 期 限 。 当 然 这 并 不 意味 着 为 了 赶 工 
期 ， 就 可 以 心甘情愿 地 容忍 (不 是 积极 地 豆 励 ) 糟糕 的 设计 ， 但 是 当前 先 简 单 实现 ， 后 面 再 做 改 
进 也 是 很 有 实际 应 用 价值 的 。 

e@ 技术 债务 的 好 坏 

在 项 目的 生命 周期 内 ,债务 可 能 会 逐渐 累积 。 之 所 以 使 用 术语 债务 ( debt ) 是 因为 这 是 一 个 
很 好 的 隐喻 , 用 于 描述 应 该 如 何 看 待 出 现 的 问题 。 有 些 类 型 的 资金 债务 没有 一 点 错 ， 比 如 ， 你 准 
备 买 辆 车 但 无 法 一 次 付 清 车 球 , 正好 有 机 会 选择 分 十 二 个 月 无 息 贷 款 购 买 , 虽然 此 时 你 有 负债 了 ， 
但 从 长 远 看 ， 这 个 选择 负债 的 决定 也 是 好 的 。 这 辆 车 帮助 你 赚 回 了 每 月 要 文 付 的 分 期 款 ， 因 为 你 
现在 可 以 开车 按时 上 班 了 。 

当然 ， 有 些 人 负债 并 不 是 好 事 。 比 如 你 在 不 清楚 如 何 还 球 的 情况 下 用 信用 卡 洋 了 一 些 餐 侈 品 ， 
最 终 肯 定 会 陷入 一 个 总 在 以 最 低 限 度 支 付 利 息 的 恶性 循环 中 。 直 到 事后 , 你 才 会 发 觉 这 是 一 个 多 
么 糟糕 的 债务 决定 。 问 题 的 关键 点 在 于 ,首先 要 仔细 分 辨 候选 项 ， 然 后 再 决定 是 要 背负 债务 还 是 
要 提前 全 球 付 清 。 

软件 开发 也 有 同样 的 折 中 。 你 可 以 选择 暂时 先 实 现 一 个 次 优 的 方案 来 确保 不 错过 最 后 期 限 ， 
或 者 选择 花费 更 长 时 间 来 改善 设计 但 是 会 错过 最 后 期 限 。 选择 没 有 绝对 的 对 错 , 只 有 分 析 具 体 情 
况 才 能 判断 引入 技术 债务 是 对 还 是 错 。 

@ 技术 债务 象限 图 

Martin Fowler 是 一 位 非常 杰出 的 敏捷 先行 者 。 他 提出 了 技术 债务 象限 图 的 定义 ， 用 于 对 完成 
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故事 可 能 需要 做 出 的 折 中 和 受 协 进行 归 类 。 象 限 图 的 x 和 y 轴 将 一 个 平面 划分 成 四 个 象限 ，x 轴 代 
表 问题 “是 否 在 为 正当 的 原因 积累 技术 负债 ? ”，) 轴 代表 问题 “是 否 有 其 他 的 替代 方案 可 以 避免 
技术 负债 ? “。 
如 果 你 对 第 一 个 问题 回答 “是 ”， 那 么 你 在 引入 一 个 有 着 长 期 利益 的 技术 债务 ， 因 为 你 能 指 
出 增加 债务 的 正当 理由 而 且 你 也 很 清楚 要 注意 什么 。 如 有 果 你 回答 “ 否 ”"， 那 么 这 个 俩 务 是 有 人 负面 
后 果 的 ， 你 最 好 现在 就 处 理 掉 这 个 债务 ， 而 不 应 该 允许 这 种 债务 继续 增加 。 
对 于 第 二 个 问题 , 肯定 的 回答 代表 你 已 经 考虑 了 债务 的 替代 方案 且 决 定 当前 先 引 入 这 个 技术 
负债 。 和 否定 的 回答 则 表明 了 你 并 没有 为 引入 的 技术 债务 认真 考虑 过 其 他 的 替代 方案 。 
问题 的 答案 组 成 了 图 1-5 展 示 的 四 个 可 能 的 场景 。 
口 不 计 后 果 的 ， 有 意 的 : 这 种 类 型 的 负债 是 最 糟糕 的 。 相 当 于 在 说 “我 没有 时 间 设 计 ”， 这 
代表 了 一 种 很 不 健康 的 工作 环境 。 出 现 这 样 的 决定 时 ， 就 应 该 给 每 个 成 员 提出 警告 : 现 
在 的 团队 不 能 适应 当前 状况 ， 而 且 正 在 走向 注定 失败 的 结局 
口 不 计 后 果 的 ， 无意 的 : 这 种 类 型 的 债务 大 多 数 是 因为 缺乏 经 验 才 引 和 的。 这 是 由 于 开发 
人 员 不 够 了 解 现代 软件 工程 的 最 佳 实践 导致 的 。 很 像 上 一 个 场景 ， 代 码 很 可 能 是 乱糟糟 
的 ， 但 是 开发 人 员 不 知道 还 有 更 好 的 可 供 选择 的 替代 方案 。 解 决 方案 就 是 再 学 习 ， 只 要 
开发 人 员 愿 意 学 习 ， 他 们 就 可 以 停止 引入 这 种 类 型 的 技术 债务 。 
口 谨慎 的 ， 无意 的 : 这 种 类 型 的 债务 发 生 在 当 你 遵循 了 最 佳 实践 时 ， 却 发 现 仍 有 更 好 的 方 
法 。“ 虽 然 现 在 没 做 , 但 是 已 经 知道 以 后 该 怎么 做 了 。” 这 和 前 一 种 场景 类 似 ， 不同 的 是 ， 
这 种 情况 发 生 时 所 有 的 开发 人 员 的 意见 是 一 致 的 ， 那 就 是 当时 他 们 都 不 知道 还 有 更 好 的 
方案 可 供 选 择 。 
口 谨慎 的 ， 有 意 的 : 这 是 最 令 人 满意 的 债务 类 型 。 你 已 经 认真 考虑 到 了 所 有 的 候选 项 ， 也 
很 明白 自己 正在 做 什么 ， 也 知道 为 什么 要 引入 这 个 债务 。 引 入 这 种 类 型 的 债务 后 ， 通 党 
会 伴随 一 个 这 样 的 决定 :“ 现 在 先 发 布 ， 然 后 再 处 理 那 些 已 经 考虑 清楚 的 问题 ”。 


不 计 后 果 的 | 谨慎 的 
































ee “现在 先 发 布 ， 然 后 
人 再 处 理 那些 已 经 考虑 
els 清楚 的 问题 。” 


有 意 的 





无 意 的 


“虽然 现在 没 做 ， 
该 怎么 做 了 。” 





图 1-5 正如 Martin Fowler 所 描述 的 那样 ， 技 术 全 务 象限 图 能 让 开发 人 员 明 日 技术 债务 
可 以 归 为 四 类 
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@ 债务 偿还 

技术 债务 和 缺陷 一 样 , 不 能 直接 持 有 故事 点 数 , 但 是 即使 缺乏 直接 的 激励 ， 作 为 债务 依然 是 
必须 要 偿还 的 。 最 好 的 方式 是 给 故事 再 附加 一 个 技术 债务 卡 , 并 且 重 构 代 码 以 实现 新 的 设计 和 行 
为 。 再 从 面板 中 取 候 选 的 故事 时 ， 就 需要 检查 是 否 有 任何 要 改动 的 代码 带 有 技术 负债 ， 如 果 有 ， 
就 将 该 技术 负债 和 该 故事 放 在 一 起 处 理 。 

4. 数字 Scrum 面 板 

如 有 果 不 把 数字 Scrum 面 板 一 直 挂 在 增 上 ， 就 一 定 会 隐藏 很 多 重要 的 项 目 信 息 。 通 过 开放 信息 
并 让 整个 公司 都 看 到 它们 ,你 可 以 邀请 人 们 对 流程 提出 问题 。 流 程 越 透明 越 好 ,特别 是 当 你 在 公 
司 第 一 次 引入 Scrum 实 践 时 。 它 辟 励 获取 重要 干系 人 的 反馈 ， 你 应 该 很 好 地 引导 这 些 干 系 人 参与 
到 流程 中 来 。 

话 虽 老 套 ,但 是 人 们 的 确 很 害怕 改变 。 害 民 和 焦虑 是 人 本 号 对 未 知 的 自然 反应 。 通 过 告知 人 
们 你 在 做 什么 和 特定 图 表 表 达 的 意义 ( 以 及 为 什么 墙 上 会 有 很 多 的 索引 卡 )， 你 能 将 协作 沟通 的 
积极 态度 推广 给 了 大 家 。 此 外 ,给 一 个 外 行 解释 这 些 信息 对 你 也 是 有 好 处 的 ， 因 为 你 的 解释 过 程 
或 许 会 让 你 自身 对 整个 流程 有 了 更 清楚 的 理解 。 

所 有 的 工具 中 ， 最 好 的 总 是 那些 易 接 触 和 没有 约束 的 工具 。 这 些 工具 会 被 频 索 自由 地 使 用 ， 
而 当 一 个 工具 开始 变 得 有 些 不 便 使 用 时 , 它 也 逐渐 会 被 抛弃 , 那些 原本 被 经 常 使 用 却 未 能 与 时 俱 
进 的 工具 也 会 迅速 地 被 人 遗忘 。 

5. 完成 的 定义 

所 有 项 目 都 需要 完成 的 定义 ( Definition of Done，DoD )。 为 了 验收 判断 是 否 完成 ， 所 有 用 户 
故事 都 必须 符合 清晰 的 完成 的 定义 。 下 面 是 开发 人 员 经 浓 提 及 的 ， 你 有 上 听 到 过 多 少 次 呢 ? 

“做 完了 ， 不 过 我 还 要 再 做 一 下 测试 ……… ” 
“做 完了 ， 但 是 我 刚刚 又 发 现 了 一 个 问题 ， 可 能 需要 修复 ……” 
“做 完了 ， 只 是 我 觉得 设计 还 不 完美 ,我 计划 改 一 下 接口 …… 

我 过 去 也 用 过 这 些 托 样 。 如 果真 的 做 完了 ， 那 就 说 “做 完了 ”， 不 需要 再 附加 任何 说 明 、 条 
件 或 解释 。 上 面 这 儿 个 例子 实际 上 代表 着 开发 人 员 还 需要 多 一 点 时 间 ， 因 为 他 们 原先 的 估算 不 够 
好 或 者 过 到 某 个 未 预料 到 的 问题 。 所 有 人 必须 认同 并 且 至 始 至 终 遵守 完成 的 定义 。 如 果 一 个 故事 
不 符合 标准 ， 它 不 能 算是 真正 完成 了 。 只 有 符合 完成 的 定义 的 用 户 故 事 才 可 以 标记 为 完成 状态 。 

完成 的 定义 都 包含 什么 ”这 完全 取决 于 你 、 你 的 团队 , 以 及 你 想 要 的 质量 保证 流程 的 严格 程 
度 。 无 论 如 何 ， 你 可 以 参考 下 面 这 个 常用 的 完成 的 定义 。 

为 了 将 某 个 用 户 故 事 标 记 为 完成 状态 ， 必 须 确保 以 下 事项 。 

口 对 所 有 代码 的 成 功 和 失败 路 径 都 做 了 完整 的 单元 测试 ， 并 且 通 过 了 所 有 测试 。 

口 所 有 代码 都 无 误 地 提交 到 了 持续 集成 系统 中 , 编译 和 构建 是 成 功 的 , 并 且 通 过 了 所 有 测试 。 

口 通过 了 验收 标准 和 产品 负责 人 的 验收 。 

口 不 在 同一 个 用 户 故 事 下 的 开发 者 相互 实施 了 代码 评审 。 

口 只 撰写 了 适量 的 用 于 沟通 的 文档 。 
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口 拒绝 了 那些 不 计 后 果 的 技术 债务 。 

在 上 面 几 条 的 基础 上 ,你 可 以 任意 删除 、 修 改 或 者 增加 定义 条 款 , 但 是 请 务必 确保 定义 是 严 
说 的 。 如 果 一 个 用 户 故 事 无 法 满足 所 有 验收 标准 ， 你 要 么 确保 这 个 故事 仍然 能 够 满足 所 有 标准 ， 
要 么 把 要 求 比较 高 的 标准 从 完成 的 定义 中 完全 删除 。 比 如 ,如 果 你 觉得 交叉 代码 评审 太 死 板 或 没 
必要 ， 那 就 不 要 把 它 包含 在 你 的 完成 的 定义 中 。 


1.3.2 ”图 表 和 度量 标准 


在 Scrum 项 目 中 ， 有 多 个 图 表 可 以 用 来 监测 项 目 进度 。 它 们 能 够 表现 项 目的 健康 状态 和 进展 
历史 ,还 可 以 预测 后 期 可 能 取得 的 成 果 。 这 些 图 表 要 在 Scrum 面 板 上 有 着 醒目 的 位 置 ， 尺寸 大 小 
要 保证 较 远 的 时 候 也 能 看 得 清 。 这 种 公共 的 展示 方式 在 向 所 有 团队 成 员 上 暗示 , 这 些 图 表 不 是 什么 
秘密 ,也 不 是 用 来 监测 项 目 管理 的 消耗 情况 的 ; 相反 地 ， 这些 图 表 很 直接 地 展示 了 项 目 进度 的 监 
测 方式 。 这 种 公共 的 展示 方式 能 够 告诉 所 有 参与 项 目的 人 员 , 创建 这 些 图 表 不 是 为 了 监控 和 提高 
效率 ， 而 是 用 来 体现 和 诊断 整个 项 目 中 存在 的 问题 。 

此 外 , 请 尽量 避免 评测 团队 中 个 人 层面 的 任何 事情 ， 比 如 单个 开发 人 员 挣 取 的 故事 点 数 。 因 
为 这 会 错误 地 引导 团队 个 人 把 自己 的 进度 看 得 比 整个 团队 和 项 目的 进度 更 重要 一旦 有 了 这 些 个 
人 考核 标准 ,开发 人 员 会 迅速 开始 为 这 些 个 人 目标 行动 起 来 ,为 了 不 在 考核 结束 时 被 评 为 不 合格 ， 
他 们 会 尽量 去 独占 大 型 的 用 户 故 事 以 争取 这 些 故 事 的 所 有 点 数 。 所以, 请 警惕 你 对 这 种 个 人 目标 
设置 的 奖惩 机 制 。 














风 


告 请 谨慎 选择 你 要 监测 的 事项 ， 因 为 你 的 选择 会 产生 “观察 者 效应 ”。 上 比如 说 ， 对 于 某 
标准 而 言 ， 在 开始 监测 之 前 必须 先 调 整 测量 的 对 象 。 再 比如 ， 要 测量 汽车 的 胎 压 ， 就 要 先 
-人 
已 


| 


轮胎 放 点 气 以 改变 胎 压 。 人 性 也 存在 同样 的 情况 ， 当 团队 成 员 知 道 他 们 要 被 考核 时 ， 他 们 
会 竭尽 全 力 去 改善 他 们 的 数据 表现 来 达到 绩效 要 求 。 这 并 不 是 说 团队 成 员 全 都 是 利己 主义 
,而 是 说 当 团 队 成 员 认 识 到 故事 点 数 是 他 们 的 一 个 考核 标准 时 , 每 个 人 都 很 可 能 争 相 选择 
那些 高 性 价 比 的 用 户 故事 ( 也 就 是 说 ， 实 际 工作 量 一 样 但 故事 点 数 更 多 )。 这 里 需要 使 用 三 
角 测 量 法 ( 1.4.5 节 中 会 有 讲解 ) 来 调整 估算 工作 量 和 实际 工作 量 的 差距 。 


AN 


某 
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1. 故事 点 数 

故事 点 数 的 意图 是 激励 开发 团队 为 每 个 冲刺 的 发 布 增加 商业 价值 。 整个 开发 团队 会 在 冲刺 计 
划 会 议 (本章 后 面 专门 有 一 方 讲解 冲刺 计划 会 议 ) 期 间 讨 论 并 为 承诺 要 完成 的 用 户 故 事 分 配 故事 
点 数 。 一 个 用 户 故 事 点 数 用 来 衡量 实现 该 用 户 故 事 定 义 行为 所 需 的 工作 量 , 其 中 包括 了 整个 软件 
生命 周期 的 所 有 阶段 的 工作 量 : 需求 分 析 、 方 案 设 计 、 会 单元 测试 的 代码 实现 、 测 试验 收 ， 还 有 
部 署 实验 。 尽 管 每 个 故事 都 应 当 足 够 小 以 确保 能 够 在 一 个 冲刺 中 完成 , 但 是 实际 故事 的 规模 变化 
还 是 很 大 的 。 

实现 最 小 的 “一 个 点 数 的 故事 ”只 需要 最 小 的 工作 量 。 有 个 很 有 意思 但 也 很 重要 的 事实 是 ， 
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故事 点 数值 只 对 得 出 该 估算 点 数值 的 开发 团队 才 有 意义 。 因 为 技能 和 经 验 值 的 不 同 , 一 个 团队 的 
一 个 点 数 的 故事 对 为 外 一 个 团队 来 说 很 有 可 能 变 为 三 个 点 数 的 故事 。 经 过 多 个 冲刺 后 , 不 同 团队 
对 于 同一 个 故事 的 工作 量 佑 算 慢 慢 才 会 变 得 接近 了 。 

有 一 点 需要 强调 的 是 ,故事 点 数 不 是 用 来 表达 工作 量 的 绝对 时 长 天数、 小 时 数 或 者 其 他 时 
间 单 位 的 测量 值 ) 故事 点 数 只 是 根据 以 往 实 际 时 长 范围 对 工作 量 进行 粗略 的 估算 , 如 图 1-6 所 示 。 
表 中 的 垂直 线 表示 估算 的 时 间 范 围 , 附 在 垂直 线 上 的 水 平 短 粗 线 表示 相应 点 数 的 故事 实际 耗费 的 
时 长 。 























图 表 标 题 


实际 时 长 (小时) 
8 8 


故事 点 数 
图 1-6 最 小 /最 大 /平均 值 表 ， 展 示 了 估算 工作 量 与 实际 工作 量 之 间 的 关系 














从 图 1-6 中 还 可 以 看 出 : 大 的 用 户 故 事 的 实际 工作 量 时 长 范围 更 大 ， 也 应 该 更 难 准确 预计 实 
际 工 作 量 的 时 长 。 

2. 速度 

经 过 多 个 冲刺 后 , 可 以 开始 计算 已 经 完成 的 用 户 故 事 的 平均 开发 速度 了 。 假 设 一 个 团队 已 经 
完成 了 三 个 冲刺 ， 分 别 完 成 了 8 、12 和 11 个 故事 点 数 。 也 就 是 说 ， 三 个 冲刺 总 共 完 成 了 31 个 故事 
点 数 ， 平 均 每 个 冲刺 完成 10 个 故事 点 数 。“ 每 个 冲刺 10 个 故事 点 数 ” 就 是 该 团队 的 开发 速度 ， 可 
以 按照 以 下 两 种 方法 使 用 速度 值 。 

第 一 种 方法 , 团队 的 速度 可 以 作为 团队 下 一 个 冲刺 承诺 要 完成 的 故事 点 数 的 上 限 。 如 果 团 队 
每 个 冲刺 平均 能 完成 10 个 故事 点 数 , 那么 在 单个 冲刺 中 承诺 高 于 10 个 故事 点 数 并 不 只 代表 太 过 乐 
观 ， 还 意味 着 要 准备 接受 更 高 的 失败 概率 。 设 置 一 个 可 完成 的 目标 ， 然 后 完成 ， 其 至 超额 完成 ， 
这 总 比 设置 一 个 不 现实 的 目标 然后 失败 要 好 。 如 果 团 队 承 诺 了 10 个 故事 点 数 , 最 终 实际 完成 了 11， 
那么 新 的 团队 速度 就 是 11: (12+11+11)/3。 这 就 是 Scrum 流 程 的 反馈 机 制 。 

第 二 种 方法 ,团队 可 以 使 用 速度 分 析 交 付 存 在 的 问题 如果 团队 速度 在 某 个 冲刺 中 明显 变 慢 ， 
这 就 表明 冲刺 中 有 糟糕 的 事情 发 生 了 , 需要 尽快 解决 。 有 可 能 是 故事 规模 太 大 并 且 作 出 了 错误 的 
估算 ， 导致 偏差 太 大 ,这 种 大 型 故事 应 该 需要 多 个 冲刺 才 可 以 真正 完成 ; 也 有 可 能 是 因为 太 多 的 
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关键 团队 成 员 同 时 休假 或 者 生病 ， 从 而 导致 进度 变 慢 ; 另外 一 种 可 能 的 情况 是 , 团队 花费 了 太 多 
的 时 间 去 重 构 现 有 的 代码 ， 而 没有 专注 在 新 特性 的 实现 上 。 无 论 什 么 原因 ，25% 以 内 的 速度 降幅 
还 不 是 很 严重 , 但 是 它 已 经 暗示 很 可 能 会 出 现 问 题 , 一旦 问题 出 现 , 团队 应 该 及 时 处 理 。 如 果 速 
度 每 周 都 有 下 降 ， 而 且 减 速 幅 度 越 来 越 大 ,这 一 定 表 明 已 经 出 现 了 严重 的 问题 , 很 有 可 能 就 是 音 
分 代码 无 法 快速 适应 变化 导致 的 ;而 本 书 的 主旨 就 是 为 了 帮助 你 解决 这 个 问题 。 

3. 冲刺 燃 尽 图 

每 个 冲刺 开始 的 时 候 , 都 要 在 Scrum 面 板 上 创建 一 个 二 维 平面 图 , 其中, y 轴 表示 总 的 故事 点 
数 ，x 轴 表示 工作 天 数 。 如 图 1-7 所 示 ， 笔 直 的 对 角 线 也 称 为 最 吻合 线 (line ofbestfit )， 它 展示 了 
最 理想 的 冲刺 进度 中 故事 点 数 随 着 时 间 扣 除 的 过 程 。 
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图 1-7 一 个 刚 开始 的 冲刺 燃 尽 图 。 其 中 的 对 角 线 展示 了 最 吻合 目标 的 冲刺 过 程 ( 在 这 
个 例子 中 ， 目 标 是 挣 取 23 个 故事 点 数 ) 
在 每 日 站 立会 议 上 , 会 从 总 的 故事 点 数 中 扣除 所 有 从 已 经 完成 的 故事 上 挣 取 的 故事 点 数 。 图 
1-8 展 示 了 为 达到 冲刺 目标 ， 实 际 冲 刺 过 程 就 是 一 条 与 最 吻合 线 有 偏差 的 曲线 。 
冲刺 燃 尽 图 








剩余 工作 量 (故事 点 数 ) 


周 - 周三 周 四 半 五 周一 周一 周三 周 四 周 五 周一 





冲刺 进度 (工作 天 数 ) 


图 1-8 一 个 进行 到 一 半 的 冲刺 燃 尽 图 。 在 这 个 例子 中 ， 团 队 正 在 努力 让 实际 冲刺 过 程 
贴 合 “完美 路 径 ”， 尺 管 第 一 个 周 五 和 周一 期 间 并 没有 任何 进展 
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用 不 同 的 颜色 绘制 实际 进度 曲线 和 最 吻合 线 ， 可 以 让 两 者 有 视觉 上 的 差异 。 在 冲刺 过 程 中 ， 
如 果实 际 进度 曲线 位 于 最 吻合 线 的 上 部 , 这 表明 有 问题 出 现 了 , 团队 能 够 完成 的 工作 量 比 计划 的 
要 少 。 相 反 ， 如 果实 际 进度 曲线 位 于 最 吻合 线 的 下 方 , 这 表示 当前 项 目 进度 比 计划 要 快 。 在 整个 
冲刺 过 程 中 ， 有 时 会 出 现实 际 进度 曲线 在 最 吻合 线 上 下 微微 波动 的 现象 , 这 是 正常 的 。 但 是 如 果 
实际 进度 曲线 相对 于 最 吻合 线 的 波动 过 大 ， 那 就 需要 认真 查找 原因 了 。 

当 冲 刺 需 要 在 固定 时 间 段 内 完成 固定 的 工作 量 时 , 使 用 燃 尽 图 对 项 目 是 很 有 帮助 的 。 燃 尽 图 
中 ， 曲 线 是 无 法 位 于 x 轴 下 方 的 ， 因 为 当 y 等 于 0 时 ,代表 团 队 已 经 完成 了 所 有 的 工作 。 

4. 特性 燃 耗 图 

在 一 个 冲刺 中 ,冲刺 燃 尽 图 用 于 从 故事 层面 追踪 实际 的 进度 ， 而 特性 燃 耗 图 则 是 用 来 追踪 
特性 完成 的 进度 。 在 每 个 冲刺 结束 时 ， 可 能 会 完整 实现 一 个 新 的 特性 。 特 性 燃 耗 图 的 最 大 好 处 
就 是 能 防止 冒充 交付 特性 ， 因 为 图 中 的 曲线 根本 就 没有 变化 。 随 着 时 间 的 推移 ， 特 性 燃 耗 图 中 
的 曲线 会 呈现 线性 增长 ， 最 理想 的 情况 是 一 直 没 有 出 现 过 平行 线 。 图 1-9 展 示 了 一 个 很 好 的 特 
性 燃 耗 图 。 








特性 燃 耗 图 
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图 1-9 ”这 个 特性 燃 耗 图 展示 了 一 个 健康 的 项 目 在 一 年 中 持续 进展 的 过 程 


图 1-9 中 曲线 坡度 可 能 有 些 平 缓 ， 但 它 表 明了 团队 的 开发 节 委 很 好 ， 正 在 以 一 种 可 预期 的 速 
度 持续 交付 特性 。 虽 然 与 完美 的 直线 有 点 偶 离 ， 但 是 这 很 正常 ， 没 什么 可 担心 的 。 

相反 ， 图 1-10 中 的 特性 燃 耗 图 已 经 表明 出 现 了 开发 问题 。 在 开始 阶段 ， 团 队 的 状态 很 好 ,人 快 
速 地 交付 了 很 多 特性 ， 但 是 后 期 整整 八 个 月 只 交付 了 两 个 特性 ， 整 个 团队 完全 陷 人 了 泥沼 。 
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特性 燃 耗 图 
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图 1-10 ”这 个 特性 燃 耗 图 展示 了 一 个 停 涡 的 项 目 在 一 年 中 绥 慢 进展 的 过 程 


这 个 问题 很 清楚 : 代码 无 法 适应 需求 的 变化 。 曲 线 前 段 的 点 可 能 表明 团队 没有 做 单元 测试 ， 
没有 做 分 层 架 构 或 者 没有 采用 其 他 的 最 佳 实践 。 通 过 忽视 了 这 些 其 实 很 必要 的 行动 , 团队 设法 早 
早 完 成 了 更 多 的 特性 。 但 是 ,代码 逐渐 变 得 愈 发 胱 肿 和 混乱 ,开发 进度 会 显 车 变 慢 ,很 长 时 间 才 
能 完整 交付 一 个 特性 。 这 种 陷于 停 澡 的 进度 很 可 能 是 由 于 大 量 累积 的 缺陷 和 糟 糕 的 技术 债务 引起 
的 。 如 果 这 个 项 目 继续 这 种 糟糕 的 状况 ,最 终 更 好 的 选择 可 能 是 重新 开始 。 长 期 来 看 ,努力 让 项 
目 重 回 正 轨 的 重 构 工作 将 会 是 非常 值得 的 。 当 然 ， 如 果 能 早早 发 现 问 题 , 团队 和 项 目 就 能 够 重新 
恢复 。 尽 管 如 此 , 还 是 建议 从 项 目 一 开始 就 正确 地 应 用 各 种 敏捷 开发 的 优秀 实践 ， 而 不 是 等 进行 
中 的 项 目 (brownfield project ) 空 得 一 团 糟 的 时 候 才 引入 这 些 实践 。 














注意 ”brownfield 是 指 项 目 已 经 处 于 进行 中 的 状态 。 与 它 相 反 的 是 greenfield 项 目 ， 代 表 新 
的 还 未 启动 的 项 目 。 这 两 个 术语 都 是 从 建筑 产业 借鉴 而 来 的 。 


1.3.3 ”积压 工作 


积压 工作 是 一 个 列表 , 其 中 包含 了 一 些 需 要 处 理 的 待定 工作 项 。 这 些 工 作 项 在 合适 的 时 间 会 
从 积压 工作 中 取出 ， 然 后 处 理 直 至 完成 。 每 个 工作 项 都 有 自己 的 优先 级 和 工作 量 估算 值 ， 整 个 积 
压 工 作 列 表 是 按照 优先 级 高 低 和 工作 量 大 小 进行 排序 的 。 

Scrum 过 程 中 维护 了 两 个 积压 工作 : 产品 积压 工作 和 冲刺 积压 工作 ， 它 们 分 别 有 着 自己 特有 
的 用 途 。 

1. 产品 积压 工作 
在 产品 生命 周期 内 , 产品 积压 工作 上 总 是 包含 一 些 待 实现 的 特性 。 因 为 产品 积压 工作 中 的 特 
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性 还 没有 被 取出 并 放 入 到 冲刺 当中 , 所 以 开发 团队 实际 上 并 不 会 处 理 产 品 积 压 工 作 上 的 特性 。 尽 
管 如 此 ,开发 团队 (或 者 团队 的 代表 ) 仍 需要 花 时 间 去 评估 这 些 特性 的 工作 量 。 花 时 间 评 佑 特性 
工作 量 也 有 助 于 对 这 些 产品 积压 工作 上 的 特性 进行 排序 , 以 此 保证 产品 积压 工作 上 所 有 的 特性 总 
是 排 好 序 的 。 

每 个 特性 业务 价值 的 高 低 决定 了 各 自 的 优先 级 别 的 高 低 , 特性 的 业务 价值 是 由 产品 积压 工作 
的 所 有 者 ( 即 产 品 负 责 人 ) 来 决定 的 。 产 品 负责 人 会 向 开发 团队 描述 具体 业务 并 为 特性 定义 明确 
的 业务 价值 。 为 了 挖掘 和 定义 具体 特性 内 在 的 业务 价值 , 产品 负责 人 必须 有 丰富 的 业务 知识 和 工 
作 经 验 。 当 产品 积压 工作 上 的 两 个 特性 的 业务 价值 一 样 重要 时 , 特性 所 需 工 作 量 的 大 小 会 决定 二 
者 的 优先 级 。 假 设 有 两 个 高 业务 价值 的 特性 ， 相 比较 其 中 一 个 所 需 工 作 量 要 大 一 些 , 那么 应 该 首 
先 实现 工作 量 小 的 特性 。 因 为 工作 量 相对 较 小 的 特性 ， 风 险 会 小 一 些 ,， 实现 周期 也 会 短 一 些 ， 相 
应 的 投资 回报 率 ( Return On Investment，ROI ) 也 会 高 一 些 。 

当 业 务 需 要 发 布 产 品 的 新 版 本 时 , 有 两 种 方式 可 以 根据 产品 积压 工作 为 这 个 发 布 选择 最 有 价 
值 的 特性 。 第 一 种 是 业务 需求 已 经 确定 了 最 终 的 发 布 日 期 , 需要 根据 估算 的 工作 量 和 可 用 时 间 从 
产品 积压 工作 中 选择 可 能 完成 的 特性 。 第 二 种 是 业务 需求 已 经 确定 了 最 终 的 发 布 特性 ， 只 需要 根 
据 从 产品 积压 工作 中 选择 的 目标 特性 的 估算 给 出 预计 的 发 布 日 期 。 

除了 特性 外 , 产品 积压 工作 还 可 以 包含 那些 必须 要 修复 但 仍 未 进入 任何 冲刺 的 缺陷 。 与 特性 
一 样 ， 也 可 以 给 缺陷 指定 业务 价值 。 此 外 ， 巾 于 缺陷 的 根本 原因 还 不 清楚 ， 因 此 在 确定 缺陷 修复 
工作 量 之 前 ， 可 能 需要 时 间 对 它们 进行 估算 。 

产品 积压 工作 也 应 该 像 其 他 敏捷 文档 一 样 保持 开放 。 所 有 人 都 应 该 能 够 看 到 产品 积压 工作 文 
档 ， 可 以 在 产品 开发 期 间 贡 献 想 法 ,提出 建议 或 指出 问题 。 同样， 产品 积压 工作 需要 时 刻 展示 权 
威 的 、 真 实 的 项 目 状态 。 很 多 时 候 , 错误 的 决定 都 源 自 不 准确 的 信息 ,根据 过 期 的 产品 积压 工作 
制定 的 关键 发 布 计划 执行 起 来 肯定 会 是 一 团 糟 。 

2. 冲刺 积压 工作 

冲刺 积压 工作 包含 了 所 有 在 即将 开始 的 冲刺 中 承诺 要 完成 的 用 户 故事 。 冲 刺 开 始 的 时 候 ， 
队 会 根据 当前 开发 速度 和 待 开发 故事 的 工作 量 估算 为 冲刺 选择 足 量 的 工作 。 选 定 故 事后 , 团队 可 
以 开始 将 所 选 故事 分 解 为 任务 ,并 使 用 实际 时 间 单 位 小 时 来 度量 这 些 任务 的 工作 量 。 最 后 ,团队 
中 每 个 开发 人 员 再 为 自己 选取 足 量 的 任务 。 

开发 团队 全 权 人 负责 冲刺 积压 工作 及 其 工作 量 估算 。 其 他 人 没有 权力 给 冲刺 积压 工作 增加 工作 
项 ,也 不 可 以 为 开发 团队 指定 工作 量 估算 。 尽 管 详细 的 冲刺 积压 工作 是 由 开发 团队 单独 定义 ,但 
是 它 必 须要 基于 有 优先 级 排序 的 产品 积压 工作 。 


1.4 ”冲刺 


Scrum 项 目的 欠 代 被 称 为 冲刺 。 一 个 冲刺 周期 最 短 一 周 ， 最 长 四 周 ， 最 稼 见 的 是 两 周 。 如 果 
冲刺 周期 太 短 ， 开 发 团队 没有 足够 时 间 来 完成 既定 目标 ， 太 长 又 容易 让 团队 失去 工作 焦点 。 
冲刺 通常 有 数字 索引 ,从 神 刺 0 开始 。 冲 刺 0 的 目的 是 让 团队 准备 开发 环境 以 及 在 后 续 真 正 的 
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冲刺 开始 前 召开 一 些 主要 的 计划 会 议 。 冲 刺 0 很 可 能 没有 故事 点 数 , 但 是 冲刺 0 中 完成 的 准备 工作 
会 对 过 渡 到 后 续 Scrum 冲 刺 有 很 多 好 人 处。 

大 家 很 容易 就 会 想 按 照 工 作 周 来 安排 冲刺 ， 也 就 是 说 从 周一 开始 ， 到 周 五 结束 。 这 种 安排 的 
问题 是 冲刺 回顾 (后面 章节 会 简短 讲解 ) 会 需要 大 量 的 会 议 时 间 , 但 是 没有 人 襄 欢 在 周 五 的 下 午 
无 精 打 采 地 坐 在 会 议 室 开 半 天 的 会 。 因 为 通常 周 五 很 多 人 都 打算 早早 离开 办 公 室 ,而 且 周 末 马 上 
到 了 ,大 家 精力 都 不 够 集中 ,工作 效率 很 可 能 会 下 降 。 同 样 地 ， 也 没有 人 喜欢 每 周 上 班 的 第 一 天 
就 开 半 天 的 会 。 因 此 ， 最 好 的 安排 是 在 周 中 ( 周二 、 周 三 或 者 周 四 ) 启动 冲刺 以 避免 上 面 提 及 的 
问题 。 

下 面 按照 出 现 顺序 讲解 冲刺 中 出 现 的 所 有 会 议 。 

1.4.1 发布 计划 会 议 

软件 的 发 布 计划 必须 在 冲刺 开始 前 就 准备 好 。 为 此 ， 用户 和 产品 负责 人 需要 在 发 布 计划 会 议 
上 决定 发 布 日 期 以 及 该 发 布 所 包含 特性 的 优先 级 排序 和 工作 量 估算 。 

1. 特性 工作 量 估算 

无 论 特性 的 规模 多 大 ， 都 可 能 会 有 大 量 的 工作 要 做 。 因 此 , 任何 尝试 准确 预计 所 需 工 作 量 的 
效果 都 有 可 能 大 打折 扣 。 鉴 于 这 个 原因 ， 特 性 工作 量 的 估算 可 以 使 用 常见 的 T 恤 码 号 来 计量 。 

口 特大 码 (XL ) 

口 大 码 (LL) 

口中 码 (M) 

口 小 码 (S ) 

口 特 小 码 ( XS ) 

2. 特性 优先 级 

特性 的 优先 级 排序 也 很 重要 ,因为 有 时 很 难 预 计 一 个 实际 的 发 布 最 终 能 包含 多 少 个 特性 。 在 
一 个 特定 的 发 布 中 ， 需 要 给 每 个 特性 指定 下 面 三 种 优先 级 中 的 一 种 。 

口 必需 的 〈Required ) 

口 首选 的 (Preferred ) 

口 想 要 的 (Desired ) 

所 有 必需 的 特性 构成 了 最 小 可 行 发 布 。 首 选 的 特性 是 在 冲刺 时 间 有 有 僵 余 的 情况 下 才 需 要 处 
理 。 想 要 的 特性 优先 级 是 最 低 的 ， 它们 都 只 是 一 些 锦上添花 的 特性 ( 当然 , 用户 肯 定 会 想 如 果 能 
在 发 布 中 包含 这 些 特 性 那 也 挺 好 的 )。 

此 外 ， 业 务 干系 人 要 给 所 有 特性 编号 ， 以 便 开发 团队 能 够 按照 明确 的 优先 级 顺序 实现 每 个 


特性 。 
1.4.2 ”冲刺 计划 会 议 
冲刺 计划 会 议 的 输出 应 该 是 所 有 和 承诺 要 在 该 冲刺 中 完成 的 用 户 故 事 的 估算 。 与 Serum 的 其 他 
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流程 一 样 ,用户 故 事 估算 流程 也 有 很 多 种 变 体 。 本 节 主 要 讨论 计划 扑克 和 亲 和 估 算 ， 前 者 是 很 党 
见 的 一 种 估算 讨论 的 方式 , 后 者 是 一 种 快速 估算 故事 相对 大 小 的 方法 。 当 用 户 故 事 数量 比较 多 的 
时 候 ， 亲 和 估算 会 更 合适 一 些 。 在 一 个 单独 的 冲刺 内 ， 当 要 估算 的 用 户 故 事 数目 不 多 时 ， 可 以 使 
用 计划 扑克 ， 而 当 故 事 数量 太 大 或 者 时 间 太 短 时 ， 就 可 以 使 用 亲 和 估 算 。 

1. 计划 扑克 

计划 扑克 讨论 环节 需要 整个 开发 团队 参与 ,包括 业务 分 析 人 员 、 开 发 人 员 以 及 测试 分 析 人 员 ， 
此 外 还 包括 Scrum 主 管 以 及 产品 负责 人 。 开 始 讨论 时 ， 首 先 对 产品 积压 工作 上 每 个 用 户 故 事 作 一 
些 详细 的 介绍 ， 然 后 要 求 每 个 人 用 故事 点 数 来 给 故事 的 大 小 投票 。 

为 了 避免 故事 点 数 都 比较 接近 的 情况 ， 最 好 事先 对 可 选 点 数 进 行 限制 。 比 如 ， 钳 见 的 一 组 故 
事 点 数 是 经 过 修改 的 斐 波 那 契 数 列 : 1、2、3、5、8、13、20、40 和 100。 无论 选择 何 种 点 数 序列 ， 
总 的 故事 点 数 的 个 数 必须 是 有 限 的 ， 而 且 点 数 之 间 的 间隔 应 该 逐渐 变 大 。0 作 为 最 小 的 点 数值 ， 
可 以 加 到 序列 中 来 表达 “无 需 任 何 工 作 ”， 因 为 有 些 故 事 的 工作 量 几乎 是 可 以 忽略 不 计 的 。 序 列 
中 最 大 的 点 数值 用 来 表达 该 故事 规模 太 大 , 无 法 在 一 个 冲刺 内 完成 , 在 真正 进入 开发 前 需要 作 进 
一 步 的 竖 切 。 

投票 时 可 以 使 用 真正 的 扑克 牌 , 不 过 , 利用 闲置 的 索引 卡 甚至 直接 写 上 数字 的 白 纸 也 不 错 。 投 
票 时 ， 所 有 人 必须 同时 展示 出 自己 卡片 上 的 故事 点 数 ， 这 样 可 以 避免 在 确定 故事 点 数 时 相互 干扰 。 
当然 投票 结果 不 是 每 次 都 可 以 达成 一 致 的 , 很 多 时 候 团队 成 员 间 会 出 现 较 大 的 分 歧 。 这 种 现象 非常 
正常 ,因为 总 会 有 个 别人 出 现 估算 偏差 的 , 他 们 需要 在 达成 一 致 的 目标 下 重新 考量 自己 的 估算 。 比 
如 ， 当 平均 点 数 是 8 而 有 人 却 投了 1 时 , 会 议 主持 者 应 该 ( 礼貌 地 ) 要 求 该 投票 人 解释 他 认为 所 投 故 
事 工 作 量 这 么 小 的 原因 。 同样 地 , 超过 平均 值 过 多 的 投票 者 也 需要 给 大 家 解释 他 们 认为 工作 量 很 大 
的 原因 。 整 个 讨论 都 是 为 了 得 出 一 个 整个 团队 都 认可 的 、 实 现 该 用 户 故 事 所 需 的 故事 点 数 。 

当 投票 者 讲述 了 理由 之 后 , 可 能 需要 重新 投票 ,因为 其 他 人 也 许 发 现 自己 的 估算 过 大 或 过 小 
了 ， 而 刚才 偏离 平均 值 的 人 才 是 正确 的 。 最 终 ， 所 有 人 会 达成 一 致 并 得 到 合适 的 故事 点 数 。 当 已 
经 估算 的 用 户 故 事 点 数 之 和 达到 团队 当前 的 速度 时 ,就 可 以 停止 讨论 和 评估 剩余 的 故事 了 ， 因 为 
每 个 冲刺 能 够 选择 的 最 大 工作 量 应 该 不 大 于 团队 当前 的 开发 速度 。 












































避免 出 现 帕 金 森 定 律 所 揭示 的 现象 
帕 金 森 定 律 指出 : 
“大 多 数 情 况 下 ， 人 们 会 应 付 工作 直至 耗 尽 所 有 可 用 的 时 间 。 
当 你 不 使 用 实际 时 间 单 位 来 估算 用 户 故事 的 时 候 ， 出 现 帕 金森 定律 所 说 现象 的 几率 也 
就 变 小 了 。 团 队 从 始 至 终 都 应 该 聚焦 在 尽快 完成 故事 的 行动 上 ， 也 就 是 说 尽快 满足 完成 的 


2. 亲 和 估 算 
亲 和 佑 算 的 提出 是 为 了 解决 计划 扑克 的 局 限 性 ,因为 如 果 故 事 数目 很 大 时 , 使 用 计划 扑克 方 
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法 达成 估算 需要 耗费 大 量 的 时 间 。 使 用 亲 和 售 算 方 法 ,团队 无 需 逐 个 讨论 每 个 故事 ， 只 需要 从 产 
品 积压 工作 中 提取 两 个 优先 级 最 高 的 故事 并 对 比 它们 的 工作 量 大 小 , 然后 将 小 故事 的 卡片 放 在 桌 
子 的 左 侧 ， 大 故事 的 卡片 放 在 桌子 的 右 侧 。 

然后 , 团队 成 员 再 从 产品 积压 工作 中 取出 优先 级 最 高 的 一 个 故事 , 并 根据 该 故事 的 大 小 把 它 
放置 在 已 有 的 小 或 大 故事 的 周边 。 如 有 果 放 在 小 故事 左 侧 , 代表 更 小 ; 放 在 大 故事 右 侧 , 代表 更 大 。 
如 果 放 在 某 个 故事 ( 不论 大 小 ) 上 面 ， 代 表 与 该 故事 大 小 基本 一 致 。 如 果 放 置 于 两 个 故事 之 间 ， 
则 代表 着 大 小 在 二 者 之 间 。 如 此 反复 ， 直 至 觉得 当前 冲刺 的 故事 工作 量 已 经 达到 饱和。 

这 种 方法 按照 相对 大 小 对 故事 进行 分 组 , 团队 可 以 按照 计划 扑克 方法 中 提 及 的 经 过 修改 的 斐 
波 那 自 数列 从 左 至 右 地 给 所 有 故事 组 分 配 故 事 点 数 。 如 末 要 估算 的 故事 很 多 或 没有 时 间 逐 个 估 
算 ， 此 时 亲 和 佑 算 就 是 一 个 很 好 的 办 法 , 因为 它 能 根据 故事 的 相对 大 小 很 快 得 到 所 有 故事 的 点 数 
佑 算 。 

















1.4.3 每 日 站 立会 议 


尽管 有 几 个 Scrum 会 议会 持续 好 几 个 小 时 ， 但 是 平时 几乎 感觉 不 到 Scrum 流 程 在 运作 ， 只 有 
在 每 日 Scrum 会 议 上 才能 看 到 ， 这 个 会 议 也 被 称 之 为 “每 日 站 立会 议 ”。 

召开 这 个 会 议 的 时 候 ， 所 有 团队 成 员 都 要 围 着 Scrum 面 板 站 立 ， 每 个 人 都 要 面 对 着 其 余 团 队 
成 员 发 言 。 每 日 站 立会 议 的 持续 时 间 最 长 不 应 超过 十 五 分 钟 。 为 了 保持 会 议 的 高 效 ， 每 个 人 都 应 
该 回答 下 面 三 个 问题 。 

口 昨天 做 了 什么 ? 

口 今天 计划 做 什么 ? 

口 遇 到 了 什么 障碍 ? 

日 站 立会 议 的 重点 是 给 所 有 团队 成 员 公 开 昨 天 的 实际 进度 以 及 今天 的 预计 进度 ,在 讲述 昨 
天 完成 了 什么 的 时 候 ， 你 可 以 自由 更 新 Scrum 面 板 ， 把 卡片 从 一 个 泳 道 挪 到 另外 一 个 泳 道 ， 或 把 
小 头像 从 一 个 卡片 挪 到 另外 一 个 卡片 上 , 同时 概要 地 讲述 昨天 的 工作 情况 和 感受 。 如 果 当 前 手头 
上 没有 任务 了 ， 你 需要 在 会 议 上 告知 Scrum 主 管 并 申请 新 的 工作 项 。 障 碍 是 指 所 有 可 能 影响 你 达 
成 今天 目标 的 事情 。 因 为 你 需要 在 明天 的 站 立会 议 上 声明 你 今天 做 的 事情 ,所 以 记录 下 任何 有 可 
能 影响 你 完成 计划 的 事情 非常 重要 。 障 碍 有 可 能 与 工作 内 容 直接 相关 ， 比 如 “如 果 网 络 还 像 昨 天 
那样 断 开 ， 我 将 无 法 继续 今天 的 工作 ”， 或 者 只 是 与 工作 无 关 的 个 人 事宜 ， 比 如 “我 下 午 两 点 预 
约 去 看 牙医 ， 所 以 我 很 可 能 无 法 完成 计划 ”。 不 论 障碍 是 什么 ， Scrum 主管 都 应 该 记录 下 来 以 了 解 
所 有 人 手头 上 的 故事 进度 和 状态 。 























表情 日 历 〈niko-niko calendar) 
表情 日 历 有 时 也 称 为 “情绪 面板 ”( 日 语 中 ，niko-niko 的 意思 是 “笑脸 ”)， 它 作为 一 个 
晴雨 表 能 很 好 地 反应 团队 成 员 在 冲刺 期 间 对 进度 的 感受 。 表 情 日 历 画 在 Scrum 面 板 上 ， 行 名 
是 冲刺 的 工作 日 ， 列 名 是 成 员 名 字 ， 如 图 1-11 所 示 。 
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图 1-11 表情 日 历 可 以 清楚 明了 地 展现 出 了 成 员 冲 刺 状 态 的 好 坏 


在 每 日 站 立会 议 上 ,每 个 人 都 要 在 自己 昨天 的 日 历 格 子 上 放置 一 个 贴纸 ,这 种 贴纸 有 绿 、 
黄 、 红 三 种 颜色 ,分 别 代 表 昨 天 的 工作 状态 : 好、 一般、 糟糕 。 表 情 日 历 能 清楚 明了 地 展示 
出 ， 有 些 成 员 因为 进度 一 直 不 好 需要 帮助 ， 只 是 他 们 可 能 不 想 主动 提出 来 。 

表情 日历 只 是 另外 一 个 有 助 于 促进 反馈 效率 的 测量 方法 。 如 果 所 有 团队 成 员 持 续 地 对 他 
们 手头 的 工作 提 不 起 精神 , 此 时 可 能 需要 提 振 一 下 团队 的 士气 了 。 如 果 只 有 团队 中 某 个 成 员 
一 直 感 觉 很 粮 糕 , 而 其 他 人 状态 都 还 不 错 , 这 说 明 这 个 成 员 进 度 落后 太 多 或 者 根本 不 喜欢 自 
己 手 头 的 任务 。 最 粳 糕 的 情况 是 ,冲刺 快要 结束 时 整个 团队 还 自我 感觉 良好 ,， 但 实际 上 代码 
一 团 糟 ， 客 户 都 在 敲 门 要 账 了 ， 这 只 能 说 此 时 的 团队 已 经 根本 不 在 乎 项 目 成 败 了 。 





每 个 人 发 完 言 后 ,站 立会 议 就 结束 了 。Scrum 主 管 要 特别 留意 的 是 , 不 要 让 大 家 的 发 言 跑题 ， 
因为 大 家 会 非常 容易 陷入 问题 的 讨论 当中 。 如 果 有 人 提 及 在 代码 中 看 到 了 有 着 奇怪 有 趣 表现 的 问 
题 时 ， 所 有 开发 人 员 会 立即 不 由 自主 地 开始 猜测 可 能 的 原因 了 。 要 清楚 会 议 中 有 其 他 与 会 者 ， 难 
道 测试 分 析 人 员 真 的 需要 旁听 有 关 Microsoft Visual Studio 几 乎 使 用 了 机 器 的 所 有 可 用 内 存 的 讨论 
吗 ? 当然 不 需要 。 正 确 的 做 法 是 ，Scrum 主 管 先 记录 问题 ， 会 后 再 组 织 相 关 的 人 一 起 开展 讨论 。 


























1.4.4 ”冲刺 演示 会 议 


在 冲刺 日 历 上 , 冲刺 演示 是 一 个 关键 的 会 议 。 这 个 会 议 要 在 真实 的 产品 环境 下 演示 所 有 已 经 
完成 的 故事 , 也 就 是 说 那些 符合 完成 定义 的 故事 。 开 发 团队 所 有 人 员 必 须 到 场 , 也 可 以 邀请 其 他 
干系 人 , 比如 管理 层 和 销售 团队 的 代表 。 此 外 , 任何 对 项 目 进 展 感 兴趣 的 人 都 可 以 目 由 观摩 演示 。 
所 有 项 目 都 应 该 持 有 这 种 积极 开放 的 态度 。 

从 Scrum 面 板 上 整理 好 所 有 已 经 完成 的 用 户 故 事 ， 逐 个 解释 每 个 故事 的 功能 范围 以 及 该 故事 
为 整个 项 目的 业务 所 提供 的 价值 。 故 事 所 属 特性 实现 之 后 的 表现 就 是 应 用 行为 上 有 了 变化 。 接 下 
来 就 需要 在 实际 系统 上 部 署 产品 来 为 客户 展示 这 些 变化 了 的 行为 。 要 欢迎 与 会 者 的 提问 , 但 是 要 
防止 出 现 太 多 偏离 主题 或 无 关 的 讨论 。 要 保持 整个 讨论 始终 聚焦 在 正在 展示 的 用 户 故 事 上 , 并 在 
演示 结束 后 再 与 提出 问题 的 人 作 进 一 步 深 入 讨论 ,会 上 收集 到 的 所 有 改进 的 建议 和 意见 都 要 加 入 
到 产品 积压 工作 中 , 这 样 才 可 以 作 进一步 排序 和 计划 。 有 时 也 会 发 现 演示 会 议 上 收集 到 的 某 些 改 
进 建议 的 优先 级 会 非常 高 ， 但 这 种 情况 在 实际 项 目 中 难得 一 见 。 























30 第 1 章 ， Scrum 介绍 





不 要 害怕 演示 ,演示 肯定 会 激励 后 续 的 进度 ,没有 人 会 在 什么 都 没 做 的 情况 下 就 去 中 止 演示 ， 
但 是 切忌 绕 开 完成 的 定义 去 做 演示 。 坦 诚 公 开 进 度 ， 束 不 必 隐 藏 任何 问题 。 演 示 出 现 问 题 时 , 根 
据 图 表 和 度量 标准 来 解释 可 能 的 原因 即 可 。 

在 演示 之 前 的 某 个 时 间 点 冻结 代码 也 是 个 好 主意 , 这 样 可 以 防止 开发 人 员 最 后 时 间 为 了 多 争 
取 一 些 故 事 点 数 而 仓促 修改 。 会 议 之 前 要 预 留 合理 的 时 间 来 搭建 演示 环境 和 进行 预演 , 不 要 为 了 
眼前 的 一 些 改进 而 稀里糊涂 地 给 代码 引入 技术 负 俐 。 


自律 是 一 种 始终 能 够 拒绝 眼前 诱惑 而 选择 长 期 利益 的 能 力 。 
Mike Alexander， 健 身 专家 














1.4.5 ”冲刺 回顾 会 议 


冲刺 演示 会 议 后 , 需要 对 整个 迭代 过 程 做 复 盘 来 评估 整个 冲刺 的 成 功 程度 。 有 些 团队 成 员 可 
能 在 这 个 冲刺 中 取得 了 很 好 的 战果 , 而 有 些 人 却 可 能 经 历 了 一 个 糟糕 的 冲刺 。 冲 刺 回顾 会 议 有 助 
于 团队 从 冲刺 过 程 中 整理 出 那些 需要 保持 的 好 行为 以 及 那些 应 该 避免 的 不 好 行为 。 冲刺 回顾 会 议 
的 输出 文档 不 应 该 在 会 后 就 被 束之高阁 。 应 该 在 下 一 个 冲刺 结束 时 用 它 作 对 比 , 看 看 哪些 需要 的 
改进 完成 了 ， 哪 些 错误 没有 再 反复 。 

会 议 期 间 ， 团 队 应 该 回答 以 下 问题 。 

口 做 得 好 的 标准 是 什么 ? 

口 做 得 差 的 标准 是 什么 ? 

口 需要 开始 做 什么 ? 

口 需要 停止 做 什么 ? 

口 需要 继续 做 什么 ? 

口 是 否 遇 到 任何 意料 之 外 的 事情 ? 

首先 从 积极 的 方面 开始 , 让 每 个 团队 成 员 都 说 说 冲刺 中 哪些 地 方 做 得 比较 好 。 大 家 也 许 对 冲 
刺 进 度 很 满意 ， 或 者 对 工作 质量 很 自豪 。 

接 下 来 ， 每 个 团队 成 员 需 要 讲 讲 冲刺 中 哪些 地 方 做 得 比较 差 。 也 许 是 有 些 任务 延迟 交付 了 ， 
因为 任务 实际 比 评估 时 看 起 来 要 困难 得 多 。 无 论 是 什么 问题 ,肯定 都 可 以 找到 解决 方案 。 只 要 对 
事 不 对 人 ,所 有 有 关 问 题 的 畅所欲言 都 没 错 。 团 队 成 员 之 间 不 能 出 现 指 责 , 要 以 恰当 的 方式 建设 
性 地 指出 问题 。 讨 论 问题 的 目标 只 是 为 了 改善 流程 和 产品 。 

团队 很 可 能 有 一 些 事情 没 做 但 应 该 在 后 面 加 入 到 流程 中 。 也 许 是 代码 还 没有 正式 的 单元 测 
试 ， 团 队 成 员 都 认为 应 该 在 现 阶段 引入 单元 测试 。Scrum 主 管 应 该 在 回顾 会 议 上 及 时 记录 所 有 的 
建议 以 便 在 后 期 采取 行动 。 

同样 地 ,团队 也 很 可 能 会 发 现 有 些 事情 不 能 再 继续 。 很 典型 的 例子 就 是 ,在 会 议 上 讨论 不 要 
跑题 , 不 要 在 开发 泳 道 已 经 饱满 的 情况 下 还 加 入 新 的 故事 。 后 面 这 个 问题 很 常见 ， 可 以 通过 给 特 
定 的 泳 道 增加 容量 限定 来 解决 。 通过 强制 团队 最 多 同时 开发 三 个 故事 ,可 以 鼓励 团队 尽快 完成 已 
经 开始 的 工作 ， 而 不 是 再 开始 一 些 新 的 工作 项 。 
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有 些 重 复 性 的 工作 做 好 了 也 会 有 收益 。 如 果 因为 准备 充分 取得 了 不 错 的 冲刺 演示 效果 , 那 就 
应 该 记 下 来 并 在 以 后 继续 这 个 好 习惯 。 让 人 非常 意外 的 是 , 通 营 人 们 会 很 快乐 掉 好 习惯 ， 而 坏 习 
惯 却 很 容易 如 影 随行 。 

最 后 , 团队 成 员 要 一 起 回忆 冲刺 期 间 是 否 遇 到 了 一 些 意料 之 外 的 事情 , 不 论 好 或 坏 。 对 于 不 
好 的 意外 事件 , 要 讨论 出 一 个 行动 计划 以 避免 将 来 出 现 同 样 的 问题 , 而 好 的 意外 事件 能 让 团队 知 
道 有 些 行为 是 好 的 习惯 并 应 该 继续 坚持 。 

最 后 团队 成 员 还 需要 一 起 讨论 并 为 下 一 个 冲刺 的 候选 工作 项 排列 优先 级 ,冲刺 回顾 会 议 输出 
的 文档 不 应 该 在 会 后 就 抛 之 脑 后 ， 而 是 应 该 根据 文档 记录 内 容 尽 快 采 取 行 动 。 

故事 点 数 三 角 测 量 法 

冲刺 期 间 , 团队 成 员 可 能 发 现 有 些 用 户 故 事 的 实际 工作 量 与 冲刺 计划 会 议 上 的 估算 有 些 或 多 
或 少 的 偏差 。 那 么 在 冲刺 回顾 会 议 结束 前 ， 花 上 5 到 10 分 钟 ， 根 据 故 事实 际 工作 量 ， 应 用 故事 点 
数 三 角 测 量 法 来 重新 评估 用 户 故事 的 佑 算是 有 好 人 处 的 。 

硅 十 个 冲刺 后 ,团队 会 得 到 一 组 统计 数据 ， 可 以 对 比 每 个 故事 实际 工作 量 和 估算 点 数 。 举 个 
例子 ， 也 许 团 队 会 得 到 如 表 1-1 所 示 的 数据 。 


表 1-1 一 个 假定 项 目的 实际 工作 量 统 计数 据 和 用 户 故 事 估 算数 据 的 对 比 表 格 









































故事 点 数 平均 实际 工作 量 (小 时 ) 最 小 实际 工作 量 (小 时 ) 最 大 实际 工作 量 (小 时 ) 
1 5 1 19 
2 9.5 2 23 
3 17 2 40 
9 36 20 76 
8 56 40 86 
13 88 68 154 


根据 上 面 表格 的 统计 数据 ， 如 果 一 个 用 户 故 事 估 算 为 一 个 点 数 ， 而 实际 花费 了 六 十 个 小 时 ， 
那么 这 个 故事 很 可 能 应 该 是 一 个 八 个 点 数 的 故事 。 如 有 果 开 发 情况 并 没有 好 转 〈 比如 缺席 的 开发 人 
员 还 没有 回来 )， 那 么 就 完全 可 以 认为 现 有 的 一 个 点 数 的 佑 算是 不 正确 的 。 相 反 ， 如 果 估算 这 个 
故事 为 八 个 点 数 ， 那 么 团队 的 工作 速度 不 会 受到 影响 ,团队 能 承诺 的 故事 总 数 也 不 会 减少 。™ 

此 外 ,只 需要 关注 那些 明显 偏离 的 故事 估算 。 因 为 如 果 一 个 点 数 的 故事 实际 工作 量 在 两 个 或 
三 个 点 数 的 实际 工作 量 范 围 内 时 ， 它 的 实际 工作 量 也 不 太 可 能 再 发 生 更 大 的 仿 差 。 





























1.4.6 ” Scrum 日 历 
为 了 清楚 起 见 ， 表 1-2 中 的 日 历 展示 了 一 个 冲刺 期 间 所 有 上 典型 的 Scrum 会 议 。 





J 假设 原 有 一 个 点 数 的 故事 是 三 个 开发 人 员 一 起 做 ， 结 果 其 中 两 个 人 因 事 缺 席 后 ， 剩 下 的 一 个 人 最 终 没 有 在 一 个 冲 
刺 中 完成 该 故事 ， 那 么 这 个 冲刺 团队 承诺 的 故事 数 就 会 少 一 个 。 结 合 前 几 个 冲刺 完成 的 故事 数目 求 取 平 均值 得 到 
的 团队 速度 也 会 下 降 。 作 者 在 这 里 想 描述 这 种 因 主 观 或 客观 原因 导致 估算 不 正确 的 情况 ， 上 面 这 种 实际 和 售 算数 
据 对 比 的 统计 表格 可 以 给 团队 后 续 的 估算 一 些 指导 和 参考 ， 以 减少 这 种 偏差 对 项 目的 影响 。 译 者 注 
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表 1-2 一 个 假定 项 目的 Scrum 日 历 ， 用 来 组 织 一 个 冲刺 中 的 所 有 会 议 


日 期 (2013 年 4 月 ) 时 间 会 议 类 型 与 会 者 
4 月 2 日 ， 周 二 13:00 一 15:30 冲刺 计划 会 议 开发 团队 
产品 负责 人 
4 月 3 日 ， 周 三 09:30 一 09:45 每 日 站 立会 议 开发 团队 
4 月 4 日 ， 周 四 09:30 一 09:45 每 日 站 立会 议 开发 团队 
4 月 5 日 ， 周 五 09:30 ~ 09:45 每 日 站 立会 议 开发 团队 
4 月 8 日 ， 周 一 09:30 一 09:45 每 日 站 立会 议 开发 团队 
4 月 9 日 ， 周 二 09:30 一 09:45 每 日 站 立会 议 开发 团队 
4 月 10 日 ， 周 三 09:30 ~ 09:45 每 日 站 立会 议 开发 团队 
4 月 11 日 ， 周 四 09:30 ~ 09:45 每 日 站 立会 议 开发 团队 
4 月 12 日 ， 周 五 09:30 ~ 09:45 每 日 站 立会 议 开发 团队 
4 月 15 日 ， 周 一 09:30 ~ 09:45 每 日 站 立会 议 开发 团队 
4 月 16 日 ， 周 二 10:00 一 11:20 冲刺 演示 会 议 任何 人 
11:30~ 12:00 冲刺 回顾 会 议 开发 团队 
13:00~ 15:30 冲刺 计划 会 议 开发 团队 
产品 负责 人 


通过 上 面 的 Scrum 日 历 可 以 看 出 ， 一 个 冲刺 的 演示 和 回顾 会 议 以 及 下 一 个 冲刺 的 计划 会 议 几 
乎 需要 一 整 天 来 完成 。 这 一 天 也 被 称 为 冲刺 交接 日 ,用 来 维护 冲刺 的 关注 点 ， 有 时 候 这 种 交接 也 
会 分 布 在 前 后 两 天 : 一 个 下 午 和 第 二 天 的 上 午 。 上 面 表格 中 ,如 果 冲 刺 演示 和 回顾 会 议 被 安排 到 
周二 的 下 午 ， 新 冲刺 的 计划 会 议 就 要 移 到 周三 的 上 午 。 

日 历 中 另外 值得 注意 的 一 点 是 ,每 日 站 立会 议 的 时 间 问 题 。 如 果 安 排 的 时 间 太 早 , 与 会 者 可 
能 会 因 堵 车 或 者 其 他 事由 迟到 。 同 样 ， 如 果 安 排 的 时 间 太 晚 ， 要 把 与 会 者 从 紧张 的 工作 中 拉 出 来 
也 会 不 容易 。 

可 以 把 这 些 会 议 都 加 入 到 Microsoft Outlook 或 其 他 日 历 应 用 中 ， 并 将 所 有 相关 人 指定 为 与 会 
者 ， 这 样 就 可 以 保证 所 有 人 都 能 看 到 相同 的 会 议 日 程 以 及 提醒 。 


1.5 ”Scrum 和 敏捷 的 问题 


敏捷 流程 并 不 是 保证 能 够 挽救 所 有 失败 项 目的 仙 丹 良药 ,任何 软件 开发 流程 的 目标 部 是 每 次 
都 能 保证 成 功 交 付 软 件 , 但 是 软件 依然 需要 编写 代码 才能 实现 。 任何 文档 都 无 法 掩盖 软件 产品 是 
基于 可 工作 代码 的 事实 。 

本 书 的 目的 是 为 开发 人 员 讲 解 如 何 创建 自 适 应 的 软件 方案 。 这 意味 着 这 个 方案 要 能 很 好 地 适 
应 所 有 软件 都 遇 到 的 各 种 变更 。 寄 希望 于 方案 的 第 一 次 尝试 就 能 满足 客户 的 所 有 需求 是 不 现实 
的 ， 因 此 变更 是 无 法 避免 的 。 敏 捷 流 程 〈《 也 包括 Scrum ) 的 目标 都 是 拥抱 变化 ， 并 寻求 各 种 方式 
来 确保 客户 能 够 对 已 经 实现 的 软件 行为 提出 变更 。 没 有 这 些 流 程 , 用户 可 能 只 好 不 得 不 接受 一 个 
无 法 达成 目标 的 不 合格 方案 。 
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僵硬 的 代码 


不 能 适应 变更 的 代码 就 是 伪 人 硬 的 代码 ， 反 过 来 讲 , 伪 人 硬 的 代码 也 很 难 啊 应 变更 。 分 配给 团队 
的 各 种 任务 的 估算 会 与 实际 情况 有 明显 的 偏差 ,因为 编写 代码 花费 了 太 多 的 时 间 , 而 这 是 不 应 该 
的 。 后 续 对 僵硬 代码 的 改动 还 可 能 引入 很 多 缺陷 ， 修 复 它 们 需要 更 多 时 间 、 精 力 和 资源 。 

1. 死板 

死板 的 代码 会 有 一 些 症状 表现 ,必须 完全 解决 它们 ， 否则 代码 会 越 来 越 难 改变 ， 能 交付 的 特 
性 数 日 也 会 越 来 越 少 。 

@ 缺少 抽象 

抽象 能 用 更 简洁 的 表达 来 隐藏 细节 信息 。 我 们 周围 的 抽象 示例 比比 丝 是 。 比 如 汽车 的 方向 盘 
可 以 轻松 地 引导 汽车 转 癌 ,， 它 抽象 了 复杂 的 机 械 实现 。 实际 上 ， 有 两 种 常见 的 转 癌 方式 : 齿轮 齿 
条 转 回 和 循环 球 转 回 。 无 论 是 哪 种 方式 的 实现 , 最 终 的 结果 都 是 轮子 按照 各 自 的 方式 随 着 方 回 盘 
的 转动 而 转 癌 。 左 右 轮 子 的 转 癌 量 也 不 一 样 ， 内 部 轮子 的 转 同 半径 要 比 外 部 轮子 小 ,因此 内 部 轮 
子 的 转向 角度 一 定 要 比 外 部 轮子 大 一 些 。 

当然 ,， 开车 并 不 需要 知道 这 些 细 节 。 虽然 知道 这 些 有 助 于 诊断 问题 或 者 解释 工作 原理 , 但 是 
对 于 普通 的 芍 驶 员 来 讲 ,， 这 些 无 关 芍 驶 的 信息 都 不 重要 。 抽象 对 内 隐藏 了 尽 可 能 多 的 细节 ， 对 外 
只 展示 恰好 人 够 用 的 信息 。 

抽象 在 软件 中 同样 非常 关键 。 比 如 , 用户 界 面 无 需 知 道 存放 用 户 输入 的 存储 介质 类 型 。 实 际 
上 ,如果 界面 知道 细 市 ， 这 就 说 明 软 件 的 实现 缺乏 抽象 ,这 个 用 户 界 面 会 因为 高 有 自己 不 需要 且 
不 应 该 关心 的 细节 而 变 得 很 难 使 用 。 

具有 足够 抽象 的 代码 会 更 容易 组 织 、 理 解 、 与 其 他 代码 通信 、 维 护 ， 而 且 错 误 也 更 少 。 

@ 职责 不 清 

通常 , 代码 规模 都 是 有 组 织 地 从 小 变 大 , 或 从 细小 开 碎 变 得 庞大 重要 。 随 着 更 多 变更 的 加 入 ， 
代码 也 在 一 层 一 层 地 增加 ,一 直到 “ 斥 死 骆驼 的 最 后 一 根 稻草 ”出 现 ， 某 一 次 的 改动 最 终 导 致 了 
一 连 串 相关 且 不 可 预计 的 问题 。 

这 些 代码 实现 的 方法 、 类 型 定义 其 至 整个 模块 都 没有 明确 的 目的 。 相 反 ， 这些 代码 实现 了 多 
个 不 同 的 职责 却 又 无 法 轻易 分 开 。 面 对 这 种 代码 , 本 来 只 需要 几 个 小 时 就 可 以 完成 的 变更 却 需 要 
耗费 一 天 甚至 更 多 的 时 间 , 因为 这 种 代码 中 的 一 个 改动 可 能 会 引起 一 系列 表面 上 看 起 来 无 关 的 副 
作用 。 

为 了 避免 这 种 混乱 的 现象 ， 必 须要 确保 每 个 层次 〈 方 法、 类 型 定义 以 及 程序 集 ) 的 代码 实现 
都 要 基于 单个 明确 的 职责 定义 上 。 

2. 不 易 测 试 

单元 测试 是 从 很 多 年 前 就 开始 出 现 的 编码 实践 。 对 于 很 多 开发 人 员 来 讲 , 单元 测试 很 自然 地 
是 一 个 确保 代码 正确 性 的 可 靠 方法 。 不 管 怎样 , 开发 人 员 都 需要 付出 持续 的 努力 才 可 以 长 期 确保 
代码 是 可 测试 的 。 

如 果 代 码 无 法 测试 , 那么 它 一 定 就 是 没有 经 过 测试 的 ， 如 果 代 码 没 经 过 测试 ， 那么 它 就 一 定 
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有 缺陷 。 这 里 不 需要 什么 数据 来 证 明 ,， 你 必须 假设 未 经 测试 的 代码 是 有 缺陷 的 。 这 是 面 对 未 经 测 
试 代码 时 应 该 持 有 的 怀疑 态度 。 

下 面 会 简要 介绍 几 个 概念 以 及 易 测 性 ， 后 面 第 4 章 会 作 进一步 的 详细 讨论 。 

@ 天 钧 与 塔吊 

下 面 这 上 段 文字 摘抄 自 Daniel C. Dennett 于 1995 年 撰写 的 Darwin’s Dangerous 1dea: Evolution and 
the Meanings of Life 一 书 ( 我 将 其 中 的 核心 概念 设置 为 粗 体 )。 

天 钩 (Skyhook )……: 是 生命 进化 基本 原则 的 一 个 例外 ， 它 所 产生 的 设计 全 都 是 无 

任何 明确 动机 的 突变 产物 , 与 此 相反 ,塔吊 (crane ) 则 是 该 生命 特征 设计 流程 的 一 个 特 

别 的 特征 或 是 其 一 个 子 流程 , 它 本 身 能 够 加 快 基本 上 且 缓 慢 的 物 竞 天 择 的 过 程 ， 同时 也 是 

基本 进化 流程 的 一 个 可 以 预见 的 (或 者 说 ， 事 后 可 以 清楚 解释 的 ) 产物 。 

简单 地 说 ,天 钩 会 直接 绕 过 现 有 的 所 有 生命 特征 , 它 可 以 用 来 解释 那些 跟 祖 先 毫 无 关系 的 突 
变 。 相 反 ， 塔 吊 则 与 祖先 有 痢 明 确 的 遗传 关系 ， 也 许 直到 某 个 天 钩 的 出 现 才 会 变 得 不 明显 。 

这 个 生命 进化 理论 上 的 类 比 在 编码 中 也 同样 有 用 。 天 钩 的 出 现 表 明 有 了 深层 次 的 问题 发 生 。 
应 该 把 所 有 天 钩 蔡 换 为 合适 的 塔吊 。 

天 钩 在 代码 中 很 难 用 模拟 实现 替换 , 因此 也 降低 了 代码 的 易 测 性 。 天 钓 的 示例 包括 以 下 这 些 。 

口 静态 方法 

口 静态 类 型 ( 包括 单 例 ) 

口 使 用 new 的 对 象 创建 

口 扩展 方法 

这 些 例子 都 会 妨碍 给 代码 注入 模拟 的 替代 实现 ， 从 而 让 测试 变 得 更 困难 "。 出 现 天 钩 的 地 方 
都 会 显得 没有 任何 根据 。 

幸运 的 是 ， 上 面 的 天 钩 都 有 对 应 的 塔吊 ， 而 塔吊 代码 都 可 以 从 外 部 注入 ， 与 天 钩 不 一 样 ， 出 
现 塔吊 的 地 方 都 是 有 所 依据 的 。 塔 吊 的 示例 包括 以 下 这 些 。 

口 接口 

口 依赖 注入 

口 控制 反 转 

加 :下 大- 

本 书后 几 章 会 逐个 详细 介绍 这 几 个 编码 “塔吊 ”。 

3. 度量 标准 

多 年 以 来 , 已 经 有 了 很 多 不 同 的 源 代码 度量 标准 ,它们 都 尝试 量化 并 降低 代码 的 复杂 性 ， 从 
而 评测 代码 或 整个 项 目的 健康 程度 。 

这 些 度量 标准 似乎 在 实际 项 目 中 用 得 不 是 很 多 ， 但 是 自从 中 层 管理 者 喜欢 上 源 代码 行 数 











中 虽然 困难 但 也 有 可 能 做 到 。 诸 如 TypeMock ( http://www.typemock.com ) 等 模拟 注入 框架 能 够 做 到 使 用 模拟 实现 蔡 
代 代 码 中 的 天 钩 实现 。 然 而 ， 只 有 在 使 用 第 三 方 的 不 可 改变 的 代码 库 时 ， 才 应 该 考虑 使 用 这 种 注入 框架 替换 其 中 
的 天 钩 实现 。 
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( source lines of code， SLOC ) 后 ， 源 代码 度量 标准 也 多 少 取 得 了 一 些 发 展 。 尺 管 SLOC 能 很 好 表 
现 所 需 的 工作 量 的 大 小 (代码 量 大 一 些 ， 耗 时 自然 会 多 一 些 )， 但 是 它 并 不 能 代表 系统 功能 的 强 
弱 。 同 样 ， 用 源 代码 行 数 评测 开发 人 员 的 工作 编码 效率 也 不 可 徘 。 





后 发 者 因 之 而 变 《cum hoc ergo propter hoc) 
这 名 拉丁 名 言 的 意思 是 :“ 发 生 时 有 这 个 ， 因 此 是 因为 这 个 。。 它 本 身 是 逻辑 悖 论 ( 推理 
中 出 现 自 相 矛盾 的 错误 ) 的 一 个 例子 。 因 为 根据 统计 事件 A 发 生 时 总 是 与 事件 B 有 关联 ， 所 
以 事件 A 的 发 生 都 是 由 事件 B 引 起 的 ， 这 个 推理 实际 上 是 一 种 误解 。 正 确 的 看 法 有 时 候 会 被 
引述 为 “有 关联 并 不 代表 有 因果 关系 ”。 
请 记 住 ,所 有 这 些 代码 度量 标准 希望 创造 的 价值 与 泛泛 的 “好 代码 ”的 目标 之 间 仅 仅 只 
是 关联 关系 ， 并 不 是 说 应 用 了 这 些 度量 标准 ， 就 一 定 能 得 到 真正 的 “好 代码 ”。 


e@ 单元 测试 覆盖 率 

单元 测试 覆盖 率 〈unittest coverage ) 是 用 来 度量 代码 有 单元 测试 覆盖 的 百分比 。 百 分 之 零 表 
示 所 有 代码 都 没有 任何 测试 , 百分之百 表示 每 一 行 代码 都 至 少 被 一 个 单元 测试 覆盖 到 了 。 通 常 认 
为 单元 测试 覆盖 率 至 少 要 达到 百 分 之 八 十 。 

除了 单元 测试 本 身 外 , 还 应 该 将 单元 测试 覆盖 率 检查 工具 加 入 到 持续 集成 流程 中 。 持 续集 成 
系统 会 在 每 次 看 到 新 代码 提交 时 做 一 次 全 新 的 编译 , 从 而 快速 为 开发 人 员 反馈 单元 测试 覆盖 率 的 
检查 结果 。 

因为 测试 覆盖 率 是 对 单元 测试 的 定量 度量 ,而 非 定 性 的 , 因此 它 在 实际 应 用 中 多 少 会 产生 一 
些 误解 。 比 如 通过 增加 任何 测试 就 能 轻易 地 提高 代码 覆盖 率 , 但 是 这 样 并 不 能 保证 增加 的 测试 都 
是 正确 的 。 

如 果 测 试 履 盖 率 低 于 百 分 之 八 十 (或 者 是 团队 设 定 的 其 他 标准 )， 随 着 更 多 新 代码 的 加 入 ， 
整体 覆盖 率 目 标 也 会 受到 影响 。 因 此 ,每 次 增加 新 代码 时 ， 如 果 持 续集 成 构建 过 程 发 现 覆 盖 率 低 
于 设 定 的 标准 , 就 应 该 给 出 构建 失败 的 警示 。 这 意味 着 新 加 入 的 产品 代码 必须 要 有 相应 的 单元 测 
试 , 否则 这 些 代 码 根 本 无 法 通过 持续 构建 流程 的 检查 ， 因 为 它们 会 导致 整体 测试 覆盖 率 低 于 所 设 
定 的 标准 。 

@ 图 复 杂 度 

圈 复 杂 度 (cyclomatic complexity ) 是 用 来 度量 代码 中 路 径 分 支 的 数目 。 代 码 中 每 增加 一 个 分 
支 ( if 语句、 循环 或 switch 语 句 等 )， 圈 复杂 度 也 会 相应 增加 。 图 1-12 展 示 了 一 个 简单 的 if 语 句 
及 其 内 髓 循环 的 有 向 图 ， 其 中 的 代码 路 径 数 目 就 等 于 代码 的 圈 复杂 度 。 

箭头 连 线 1 表示 if 语 句 进 入 false 分 支 , 此 时 if 条 件 为 true 的 代码 块 没 有 被 执行 。 箭 头 连 线 2 
表示 if 语句 进入 true 分 支 , 但 未 执行 内 肯 循 环 。 箭 头 连 线 3 表示 if 语句 进入 true 分 支 并 执行 了 内 
由 循环 。 

随 着 复杂 度 的 增加 ， 需 要 为 新 的 代码 分 支 编 写 更 多 单元 测试 来 保持 测试 代码 覆盖 率 。 因 此 ， 
尽量 不 要 增加 分 支 (也 就 是 复杂 度 ) 以 避免 额外 的 测试 代码 工作 。 
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此 外 也 有 统计 数据 表明 了 高 复杂 度 和 缺陷 数目 的 关系 : 分 文 越 多 的 代码 缺陷 也 越 多 。 


图 1-12 ”代码 中 每 条 路 径 都 增加 了 复杂 度 


1.6 总结 


本 章 对 Scrum 流 程 进行 了 介绍 。 如 果 你 以 前 没有 实践 过 Scrum， 我 希望 你 已 经 跃跃欲试 地 准 
备 实践 Scrum。 如 果 你 已 经 在 参与 某 个 Scrum 项 目 ， 或 许 会 想 在 手头 的 项 目 中 实践 一 下 本 章 中 提 
到 的 一 些 新 的 想法 。 

本 书 剩余 章节 将 更 多 地 从 开发 人 员 角 度 讲解 敏捷 项 目的 一 些 最 佳 实践 , 而 本 章 肯 定 有 很 多 有 
关 Scrum 的 方面 没有 涉及 ， 不 过 不 要 紧 ， 现 在 有 很 多 公开 的 学 习 Scrum 的 资源 ， 大 家 可 以 从 中 为 
自己 的 公司 和 项 目 甄选 合适 的 实践 。 

与 任何 软件 项 目 一 样 ，Scrum 项 目 也 容易 受到 失败 的 影响 。 和 定位 问题 很 重要 ， 但 是 理 清 问题 
发 生 的 根源 更 困难 。 代码 的 内 部 策划 的 设计 如 果 很 死板 ,此 时 无 论 使 用 什么 流程 来 管理 变更 都 一 
样 难以 啊 应 变更 。 本 书 剩 余 章节 会 讲解 到 一 些 建议 和 指导 原则 , 应 用 它们 可 以 确保 代码 是 目下 而 
上 自 适 应 的 ,让 变更 响应 更 容易 , 并 能 让 开发 工作 完全 聚焦 在 为 每 个 冲刺 增加 业务 价值 的 行动 上 。 
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完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 管理 从 方法 层 到 程序 集 层 的 复杂 依赖 关系 。 

口 识别 最 复杂 的 依赖 关系 并 使 用 工具 降低 复杂 度 。 

口 将 代码 拆 分 为 更 小 的 、 更 有 适应 能 力 的 、 更 易 重 用 的 功能 代码 块 。 

口 在 最 恰当 的 地 方 应 用 分 层 模式 。 

口 清楚 如 何 解 决 依赖 以 及 调试 依赖 问题 。 

口 使 用 简洁 的 接口 隐藏 实现 。 

所 有 软件 都 有 依赖 。 这 些 依 赖 要 么 是 对 同一 个 解决 方案 内 的 第 一 方程 序 集 的 依赖 ,要么 是 对 
第 三 方 外 部 程序 集 的 依赖 ， 或 者 是 处 处 可 见 的 对 Microsoft .NET Framewotk 的 依赖 。 几 乎 所 有 稍 
微 有 些 规 模 的 项 目 都 会 存在 这 三 种 依赖 关系 。 

依赖 项 抽象 了 你 编写 的 客户 端 代码 要 使 用 的 功能 。 你 不 需要 知道 依赖 在 做 什么 , 更 不 需要 知 
道 依 赖 内 部 是 怎么 做 的 , 但 是 应 该 确保 正确 管理 所 有 的 依赖 。 如 果 不 能 很 好 地 管理 依赖 链 ， 开发 
过 程 中 就 会 很 容易 引入 根本 就 不 需要 的 依赖 , 结果 就 是 代码 与 很 多 不 必要 的 程序 集 紧 紧 地 纠缠 在 
一 起 。 你 也 许 听 过 这 么 一 句 老 话 :“ 没 编写 的 代码 就 是 最 正确 的 代码 。” 同 样 ,不 存在 的 依赖 就 是 
管理 得 最 好 的 依赖 。 

为 了 让 代码 能 够 自 适 应 变更 , 你 需要 高 效 管理 所 有 的 依赖 关系 。 这 对 软件 的 所 有 层次 ， 从 架 
构 层 子 系统 间 的 依赖 到 实现 层 每 个 方法 之 间 的 依赖 , 都 是 必要 的 。 糟 糕 的 架构 会 拖延 可 工作 软件 
的 交付 ， 甚 至 导致 项 目 天 折 。 

我 认为 无 论 怎样 强调 高 效 管理 依赖 的 重要 性 都 不 为 过 。 如 果 在 重要 的 问题 上 采取 了 折 中 的 临 
时 方案 ， 也 许 短 时 间 内 可 以 提高 开发 效率 ， 但 是 长 期 的 副作用 很 可 能 会 对 项 目 造成 致命 的 伤害 。 
下 面 是 一 个 我 们 再 熟悉 不 过 的 场景 : 一 开始 ， 随 着 代码 和 模块 数量 的 增加 ， 短 期 的 开发 效率 非常 
高 。 慢 慢 地 ， 代 码 变 得 死板 和 混乱 ， 由 此 进度 也 变 得 缓慢 甚至 停滞 。 用 Scrum 的 术语 描述 就 是 ， 
在 发 现 根本 问题 前 ,缺陷 数目 在 增加 旦 无 法 获得 故事 点 数 ,， 也 就 无 法 完成 任何 故事 和 特性 ， 因 此 
冲刺 燃 尽 图 和 特性 燃 耗 图 也 会 没有 一 丝 变 化 。 当 依赖 结构 混乱 量 无 法 理解 时 , 一 个 模块 的 变更 很 
可 能 会 给 男 外 一 个 看 起 来 无 关 的 模块 带 来 副作用 。 

要 想 轻松 管理 依赖 , 需要 有 清醒 的 认识 并 按照 指导 原则 行动 。 应 用 一 些 现 有 的 模式 可 以 帮助 
代码 适应 后 期 的 变更 。 分 层 就 是 一 种 最 常见 的 架构 模式 ， 本 章 会 详细 讲解 几 种 不 同 的 分 层 方法 ， 
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此 外 也 会 介绍 其 他 一 些 依赖 管理 方法 。 


2.1 依赖 的 定义 


什么 是 依赖 ? 通常 来 讨 ， 依赖 (dependency ) 是 指 两 个 不 同 实体 间 的 一 种 联系 ， 如 果 没 有 其 
中 一 个 ， 另 一 个 就 会 缺少 某 些 功能 甚至 会 不 存在 。 一 个 比较 好 的 类 比 是 ， 某 个 人 在 财务 上 对 另外 
一 个 人 有 依赖 。 通常 的 法 律 文 件 都 需要 你 声明 是 否 有 家 属 ， 也 就 是 说 ,是 否 有 人 需要 你 来 承担 他 
们 的 生活 和 其 他 必需 品 的 费用 , 家属 通常 是 指 你 的 配偶 和 孩子 。 举 个 我 的 例子 ， 当 我 在 英国 的 百 
蔡 大 工作 时 ， 我 的 工作 许可 证 上 写 着 :“ 一 旦 我 的 工作 许可 证 失效 ,我 的 妻子 和 女儿 就 需要 和 我 
一 起 离开 工作 地 。” 这 种 情况 下 ， 她 们 作为 我 的 家 属 需 要 依靠 我 在 当地 生活 。 

在 代码 上 下 文中 看 依赖 的 定义 ， 实 体 通 常 是 指 程序 集 。 程 序 集 A 使 用 程序 集 B， 就 可 以 说 A 
依赖 B。 这 种 关系 的 一 种 常见 说 法 是 : A 是 B 的 客户 (client ), B 是 A 的 服务 ( service ), 没有 B 的 话 ， 
A 无 法 起 作用 。 人 然而，B 并 不 依赖 A 这 一 点 也 很 重要 ， 接 下 来 你 会 学 到 ，B 不 可 以 也 不 能 依赖 A。 
图 2-1 展 示 了 这 种 客户 /服务 关系 。 





























图 2-1 在 依赖 关系 中 ,依赖 者 称 为 客户 ,被 依赖 者 称 为 服务 


本 书 全 篇 都 是 以 客户 端 和 服务 端的 视角 来 讨论 代码 的 。 有 些 服务 是 在 远程 主机 上 ， 比 如 使 用 
Windows Communication Foundation( WCF ) 创建 的 服务 。 无 论 是 否 为 远程 代码 ， 都 可 以 称 为 服 
务 。 代 码 是 服务 端 代码 还 是 客户 端 代码 取决 于 你 看 待 代码 角色 的 角度 。 任何 类 、 方 法 或 程序 集 都 
可 以 调用 其 他 方法 、 类 和 程序 集 ， 因 而 代码 是 客户 端 代码 。 相 同 的 类 、 方 法 或 程序 集 也 可 以 由 其 
他 方法 、 类 和 程序 集 调用 ， 因 而 代码 也 是 服务 端 代码 。 


2.1.1 一 个 简单 的 例子 


我 们 来 看 看 具体 程序 中 的 依赖 行为 。 这 个 例子 就 是 著名 的 “Hello world” 范 例 ， 这 个 简单 的 
控制 台 程 序 只 负责 打印 一 句 消 息 。 我 选择 这 么 人 简洁 的 例子 是 为 了 能 更 清楚 地 展示 程序 中 存在 的 依 
赖 问题 。 

你 可 以 按照 下 面 步骤 创建 示例 ， 也 可 以 从 GitHub 上 直接 下 载 源 代码 。 有 关 如 何 使 用 Git 的 基 
本 介绍 请 参见 附录 。 

(1) 打开 Microsoft Visual Studio， 创 建 一 个 控制 台 程 序 。 我 把 它 命 名 为 SimpleDependency， 这 
里 名 称 不 重要 ， 可 以 随意 更 改 。 如 图 2-2 所 示 。 
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图 2-2 ”Visual Studio 的 新 建 项 目 对 话 框 中 有 很 多 不 同 的 项 目 模 板 可 选 


(2) 给 解决 方案 再 添加 一 个 新 的 类 库 项 目 。 我 的 命名 是 MessagePrinter。 

(3) 右键 单 击 控制 台 应 用 的 References (引用 ) 节点 并 选择 Add Reference ( 添加 引用 )。 

(4) 在 弹出 的 Add Reference 对 话 框 中 ， 导 航 至 Projects ( 项目 )， 然 后 选择 类 库 项 目 。 

如 图 2-3 所 示 ， 两 个 程序 集 之 间 现 在 有 了 依赖 关系 。 控 制 台 程序 依赖 类 库 ， 但 是 类 库 并 不 依 
赖 控制 台 程序 。 控 制 台 程序 是 客户 ， 类 库 是 服务 。 这 个 应 用 还 没有 什么 功能 ， 先 选择 构建 解决 方 
案 ， 人 然后 打开 SimpleDependency 项 目下 存放 可 执行 文件 的 bin 上 日 录 。 

bin 目 录 不 仅 包 含 了 SimpleDependency.exe 文 件 , 还 包含 MessagePrinter.dll 文 件 , 构建 解决 方案 
的 过 程 中 ，Visual Studio 会 自动 将 MessagePrinter.dll 文 件 复制 到 SimpleDependency 项 目的 bin 目 录 
下 , 因为 它 发 现 项 目 MessagePrinter 被 项 目 SimpleDependency 引 用 为 一 个 依赖 项 。 我 想 用 这 个 示例 
给 大 家 展示 一 个 实验 过 程 , 不 过 要 先 对 控制 台 程序 做 些小 小 的 修改 。 因 为 这 个 控制 台 程 序 什么 都 
没 做 ， 它 运行 起 来 后 会 马上 直接 退出 。 现 在 打开 控制 台 程 序 的 Program.cs 文 件 。 
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Solution Explorer sls 
人 -2 入 | < 四 
Search Solution Explorer (Ctrl+;) A- 














网 Solution 'Chapter1' (2 projects) 
4 MessagePrinter 
bp £ Properties 
pb wa References 
pb Cc: Classl.cs 
4 SimpleDependency 
bp £ properties 
mm MessagePrinter 
mm Microsoft.CSharp 
mm System 
mm System,Core 
nm System,.Data 
mm System.Data.DataSetExtensions 
mm System.Xml 
mm System.Xml.Ling 
们 App.config 
bp Cc* Program.cs 





图 2-3 ”任何 项 目的 References 节 点 下 都 会 列 出 该 项 目的 引用 程序 集 


代码 清单 2-1 展 示 了 在 Main 方 法 内 增加 的 代码 (加 粗 )。Main 方 法 是 控制 台 应 用 的 入 口 ， 修 
改 前 它 没 有 任何 动作 并 且 会 直接 退出 。 通 过 增加 调用 Console.ReadKey()， 可 以 让 应 用 一 直 保 
持 运 行 状 态 直 到 有 任何 键盘 输入 。 
代码 清单 2-1 通过 调用 Readkey 来 阻止 控制 台 程 序 立 即 退 出 


namespace SimpleDependency 











{ 
class Program 
{ 
static void Main(Q) 
{ 
Console.ReadKey() ; 
} 
} 
} 


修改 代码 后 重新 构建 解决 方案 ， 然 后 运行 应 用 程序 。 与 期 望 的 一 样 , 应 用 程序 会 显示 控制 台 
窗口 ， 并 一 直 等 待 键盘 输入 直至 退出 。 使 用 Visual Studio 在 代码 行 Console.ReadKey(0) 前 设置 断 
点 ， 然 后 选择 调试 运行 。 

当 程 序 运行 到 达 断 点 时 ， 你 能 看 到 为 该 应 用 程序 加 载 到 内 存 的 程序 集 列 表 。Visual Studio 有 
两 种 方式 可 以 查看 : 使 用 菜单 栏 依次 选择 Debug ( 调试 ) > Windows > Modules ( 模块 )， 或 者 直 
接 使 用 快捷 组 合 键 Ctrl+D+M。 图 2-4 展 示 了 为 该 应 用 加 载 到 内 存 的 模块 列表 。 

在 图 2-4 中 ， 你 有 没有 看 到 一 些 奇怪 的 地 方 ? 列表 中 并 没有 包含 你 刚刚 创建 的 类 库 。 在 这 个 
例子 里 ， 不 是 应 该 将 MessagePrinter.dll 文 件 加 载 到 内 存 中 吗 ? 实际 上 ， 不 应 该 加 载 ， 而 且 这 也 的 
确 是 期 望 的 正确 行为 。 原 因 是 : 应 用 程序 并 没有 使 用 MessagePrinter 程 序 集 内 的 任何 功能 ， 所 
以 NET 运行 时 并 不 会 加 载 它 。 

为 了 进一步 证 明 项 目 中 引用 的 MessagePrinter 程 序 集 并 非 真 的 所 需 ， 可 以 直接 到 应 用 程序 的 
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bin 目 录 下 删除 MessagePrinter.dll 文 件 。 然 后 再 次 运行 程序 ， 结 果 一 切 正常 ， 并 不 会 看 到 任何 异常 
发 生 。 








Name Path Optimized | User Code 
中 mscorlib.dll CN\WINDOWS\Microsoft.Net\asse... Yes No 
中 ”Microsoft,VisualStudio.HostingpProcess,Utilities.dll CN\WINDOWS\assembly\GAC_MS... Yes No 
名 System.Windows.Forms.dll CA\WINDOWS\Microsoft.Net\asse... Yes No 
号 System.Drawing.dll C\WINDOWS\Microsoft.Net\asse... Yes No 
有 System.dll C\WINDOWS\Microsoft.Net\asse... Yes No 
品 Microsoft,VisualStudio.HostingpProcess.Utilities.Sync.dll CNWINDOWS\assembly\GAC_MS..， Yes No 
加 Microsoft.VisualStudio.Debugger.Runtime.dlIl C\WINDOWS\assembly\GAC_MS,.. Yes No 
下 SimpleDependency.vshost.exe Ci\Users\garymcleanhal\Docum,... Yes No 
品 System.Core.dll CN\WINDOWS\Microsoft,Net\asse... Yes No 
号 System.Xml.Linq.dll CN\WINDOWS\Microsoft.Net\asse... Yes No 
中 System.Data.DataSetExtensions.dll CN\WINDOWS\Microsoft.Net\asse... Yes No 
中 Microsoft.CSharp.dll CN\WINDOWS\Microsoft.Net\asse... Yes No 
中 System.Data.dll C\WINDOWS\Microsoft.Net\asse... Yes No 
器 System.Xml.dll CANWINDOWS\Microsoft,Net\asse,.， Yes No 
中 SimpleDependency.exe Ci\Users\garymcleanhall\Docum,... No Yes 
a 











图 2-4 ”调试 时 ，Modules 和 窗口 会 显示 所 有 当前 已 经 加 载 的 程序 集 
我 们 再 重复 几 次 这 个 实验 ， 看 看 到 底 会 发 和 后 什么 。 首 先 ， 在 Program.cs 文 件 顶 部 加 入 


MessagePrinter 命 名 空间 的 using 指 令 。 你 认为 这 样 公共 语言 运行 时 ( Common Language 
Runtime，CLR ) 就 会 加 载 这 个 模块 吗 ? 答案 还 是 否定 的 。 公 共 语 言 运行 时 会 青 次 忽略 这 个 依赖 
项 ， 也 不 会 加 载 这 个 程序 集 。 这 是 因为 用 于 导入 命名 空间 的 using 语 句 只 是 一 个 语法 糖 ， 它 的 设 
计 目 的 只 是 为 了 减少 你 编写 代码 的 工作 量 。 当 你 需要 使 用 命名 空间 中 的 任意 类 型 时 ,只 需要 导入 
命名 空间 然后 直接 引用 这 些 类 型 定义 ， 而 不 需要 在 类 型 名 前 带 上 完整 的 命名 空间 。 因 此 ， 编 译 
Using 语句 并 不 会 生成 公共 语言 运行 时 要 执行 的 指令 。 

在 上 面 实验 的 基础 上 , 保留 Program.cs 文 件 顶 部 的 using 语 句 , 然后 在 Console.ReadLine() 
调用 前 再 加 入 一 个 对 MessagePrintingService 构 造 函 数 的 调用 。 如 代码 清单 2-2 所 示 。 


代码 清单 2-2 通过 调用 一 个 实例 方法 来 引入 依赖 关系 


using System; 
using MessagePrinter; 

















namespace SimpleDependency 


{ 
class Program 
{ 
static void Main() 
{ 
var service = new MessagePrintingService(); 
service.PrintMessage(); 
Console.ReadKey() ; 
} 
} 
} 





这 一 次 调试 时 的 Modules 窗 口 显 示 MessagePrinter.dll 程 序 集 已 经 被 加 载 了 , 因为 如 果 不 把 该 程 
序 集 内 容 加 载 到 内 存 ， 就 无 法 创建 MessagePrintingService 类 的 实例 。 
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如 果 想 作 进 一 步 确认 ， 可 以 尝试 删除 bin 目 录 下 的 MessagePrinter.dll 文 件 并 再 次 运行 应 用 程 
序 。 这 次 你 会 看 到 应 用 程序 引发 了 一 个 如 下 的 异常 。 
Unhandled Exception: System.I0.FileNotFoundException: Could not load file or assembly 


'MessagePrinter, Version=1.0.0.0, Culture=neutral, PublickKeyToken=null' or one of its 
dependencies. The system cannot find the file specified. 








1. 对 .NET Framework 的 依赖 

上 一 部 分 展示 的 依赖 被 称 为 第 一 方 ( first-party ) 依赖 。 控 制 侣 应 用 程序 和 它 所 依赖 的 类 库 都 
在 同一 个 Visual Studio 解 决 方案 下 。 这 就 意味 着 第 一 方 依赖 总 是 可 用 的 ， 因 为 在 需要 的 时 候 ， 被 
依赖 的 项 目 总 是 可 以 通过 源 代码 重新 构建 。 也 代表 你 能 够 直接 修改 第 一 方 依赖 的 源 代码 。 

这 个 例子 中 的 两 个 项 目 都 依赖 其 他 一 些 .NET Framework 程 序 集 。 它们 并 不 是 项 目 本 身 的 一 部 
分 ， 但 是 依然 需要 它们 是 可 用 的 。 每 个 NET Framework 程 序 集 都 带 有 自己 的 目标 框架 版 本 : 1、 
1.1、2、3.5、4 、4.5 等 。 有 些 程序 集 只 属于 某 个 新 版 本 的 .NET Framework ， 无 法 被 使 用 早期 框架 
版 本 的 项 目 引 用 。 剩 下 的 程序 集 虽 然 在 每 个 版 本 的 .NET Framework 都 有 , 但 是 不 同 版 本 之 间 是 有 
功能 差别 的 ， 所 以 在 使 用 时 需要 指定 具体 的 版 本 号 。 

如 前 面 的 图 2-3 所 示 ，SimpleDependency 项 目 对 .NET Framewotk 有 多 个 3 引用。 这 些 依赖 中 很 
多 都 是 Visual Studio 默 认 加 入 到 所 有 控制 台 应 用 程序 项 目 中 的 。 这 个 示例 控制 台 应 用 程序 并 没有 
使 用 它们 的 任何 功能 ， 因 此 可 以 放心 地 移 除 对 它们 的 引用 。 实 际 上 对 于 这 个 例子 中 的 两 个 项 目 ， 
除了 System 和 System.Core 之 外 , 其 他 的 .NET Framework 程 序 集 都 是 多 余 的 , 可 以 把 它们 从 引用 列 
表 中 删除 。 删 除 后 ， 程 序 仍然 可 以 正常 运行 。 

通过 移 除 不 必要 的 对 .NET Framework 的 依赖 ， 你 会 更 容易 看 清 每 个 项 目 必 需 的 依赖 清单 。 























框架 程序 集 总 是 会 加 载 
不 像 其 他 依赖 ， 对 .NET Framework 程 序 集 的 引用 总 是 会 导致 加 载 这 些 程序 集 。 即 使 你 并 
没有 真正 使 用 某 个 .NET Framework 程 序 集 ， 它 依然 会 在 应 用 程序 启动 的 时 候 被 加 载 到 内 存 
中 。 幸 运 的 是 ， 如 果 同 一 个 解决 方案 下 的 多 个 项 目 都 在 引用 同样 的 .NET Framework 程 序 集 ， 
在 运行 时 ， 所 有 依赖 它们 的 项 目 会 共享 同一 份 加 载 到 内 存 中 的 .NET Framework 程 序 集 实例 。 


e 默认 的 引用 列表 

Microsoft Visual Studio 中 ， 不 同 的 项 目 类 型 有 不 同 的 默认 引用 清单 。 每 个 项 目 类 型 都 有 一 
个 项 目 模 板 , 其 中 包括 了 需要 的 引用 清单 。Windows Form 应 用 程序 的 模板 中 默认 指定 的 引用 包 
括 了 System.Windows.Forms 程 序 集 ， 而 Windows Presentation Foundation ( WPF ) 应 用 程序 的 引 
用 则 包括 了 WindowsBase、PresentationCore 和 PresentationFramework 这 几 个 程序 集 。 

代码 清单 2-3 展 示 了 控制 台 应 用 程序 的 默认 引用 清单 。Visual Studio 把 所 有 项 目 类 型 的 模板 文 
件 都 存放 在 安装 目录 下 的 子 目录 /Common7/IDE/ProjectTemplates/ 下 , 其 中 每 个 语言 都 有 对 应 版 本 
的 模板 文件 。 
































2.1 依赖 的 定义 43 





代码 清单 2-3 ”Visual Studio 项 目 模板 的 一 个 片段 ， 可 以 根据 条 件 引 用 不 同 的 程序 集 


<ItemGroup> 
<Reference Include="System"/> 
$if$ ($targetframeworkversion$ >= 3.5) 
<Reference Include="System.Core"/> 
<Reference Include="System.Xml.Linq"/> 
<Reference Include="System.Data.DataSetExtensions"/> 
$endifs$ 
$if$ ($targetframeworkversion$ >= 4.0) 
<Reference Include="Microsoft.CSharp"/> 
$endifs$ 
<Reference Include="System.Data"/> 
<Reference Include="System.Xml"/> 
</ItemGroup> 








类 似 于 上 面 的 代码 清单 2-3， 在 所 有 项 目 模 板 中 都 会 根据 不 同情 况 创 建 实际 的 项 目 实 例 。 特 
别 是 , 使 用 不 同 版 本 的 .NET Framework 的 项 目 会 引用 不 同 的 程序 集 。 上 面 的 例子 中 , 我 们 可 以 看 
到 ， 只 有 当 项 目 使 用 .NET Framework 4、4.5 或 4.5.1 时 ,项 目 实 例 才 会 引用 Microsoft.CSharp 程 序 
集 。 这 样 做 的 意义 是 ， 只 有 使 用 从 .NET Framework 4 引入 的 dynami c 关 键 字 时 ， 你 的 项 目 才 需要 
引用 这 个 程序 集 。 

2. 第 三 方 依赖 

最 后 一 种 要 依赖 的 是 由 第 三 方 开 发 的 程序 集 。 通 常 ， 第 三 方程 序 集 不 是 由 .NET Framework 
提供 的 ， 你 也 可 以 选择 方案 并 直接 实现 为 第 一 方程 序 集 。 有 时 候 ， 如 果 方 案 的 规模 比较 大 ， 自 己 
编码 实现 的 工作 量 也 会 比较 大 ， 此 时 ,可 以 选择 现 有 可 用 的 方案 实现 。 举 个 例子 ,你 很 可 能 不 会 
想 去 自己 重新 实现 诸如 对 象 /关系 映射 器 ( Object/Relational Mapper, ORM ) 之 类 的 大 型 解决 方案 ， 
因为 首先 你 可 能 需要 好 几 个 月 来 编码 ,然后 可 能 再 耗费 好 几 年 时 间 来 完成 全 部 测试 ,这 种 情况 下 ， 
你 应 该 首先 看 看 .NET Framework 提 供 的 Entity Framework 是 否 够 用 ， 如 果 它 不 能 满足 你 的 需求 ， 
你 还 可 以 使 用 NHibernate， 它 是 一 个 经 过 了 广泛 测试 的 、 成 熟 的 对 象 /关系 映射 句 库 。 

只 需 集 成 现 有 可 用 的 、 满 足 需求 的 特性 或 基础 构件 的 实现 ， 而 无 需 完 全 重新 实现 它们 , 这 是 
使 用 第 三 方 依赖 的 主要 原因 。 当 然 , 集成 工作 的 难度 也 可 能 会 比较 大 ,这 个 取决 于 你 的 第 一 方 代 
码 以 及 第 三 方 代码 接口 的 结构 。 当 你 需要 使 用 迭代 方法 以 增 量 方式 ( 就 像 Scrum 流 程 ) 发 布 有 业 
务 价 值 的 特性 时 ， 使 用 第 三 方程 序 集 能 够 帮助 你 聚焦 在 业务 相关 的 工作 重点 上 。 

@ 组 织 第 三 方 依赖 

最 简单 的 组 织 方 式 就 是 直接 在 项 目 解 决 方案 下 创建 一 个 名 为 Dependencies 的 解决 方案 文件 
夹 ， 然 后 把 所 有 的 第 三 方 .dl 文 件 存放 在 这 个 文件 夹 下 。 当 项 目 需 要 引用 这 些 程序 集 时 ， 你 只 需 
要 使 用 引用 管理 絮 浏 览 这 个 文件 夹 ( 如 图 2-5 所 示 )。 

这 种 方式 的 优点 是 所 有 外 部 依赖 都 存放 到 了 源 代码 控制 平台 上 。 其 他 的 开发 人 员 从 中 心 代 码 
库 中 获取 最 新 源 代 码 时 也 能 获得 最 新 的 依赖 程序 集 , 这 样 就 不 需要 所 有 开发 人 员 单 独 下 载 和 安装 
这 些 要 依赖 的 程序 集 。 
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Reference Manager - ClassLibrary1 ? 医 到 

b Assemblies Search Browse (Ctrl+ 日 有 - 
b Solution Name Path 
WU 和 Remeotion.Mixins.dll C:\Users\garymcleanhall\Documents\GitF 

Remotion.dIl C:\Users\garymcleanhall\Documents\GitF 
4 Browse 

Recent 
4 让 
Browse... OK Cancel 











图 2-5 可 以 将 第 三 方 引 用 存储 在 Visual Studio 解 决 方案 下 的 Dependencies 文 件 夹 中 


本 章 稍 后 的 2.2.7 节 会 讲解 一 个 更 好 的 组 织 第 三 方 依赖 的 方式 。 简 单 来 计 ，NuGet 依 赖 管理 工 
具 能 够 为 开发 人 员 目 动 管理 项 目的 第 三 方 依赖 ， 它 可 以 下 载 依赖 安装 包 (包括 相关 文档 )， 引 用 
程序 集 ， 以 及 将 依赖 库 升 级 到 最 新 版 本 。 


2.1.2 ”使 用 有 向 图 对 依赖 建 模 


图 (graph ) 是 一 种 数学 建构 ， 它 包括 两 种 元 素 : 节点 和 边线 。 边 线 只 能 用 于 连接 两 个 节点 ， 
代表 了 两 个 节点 之 间 的 某 种 联系 。 几 中 的 任 一 节点 可 以 与 其 他 节点 通过 边线 连接 起 来 。 不 同属 性 
的 图 所 属 的 种 类 不 同 。 比 如 ， 图 2-6 中 展示 的 图 是 无 向 图 (undirected graph )。 这 个 图 中 ， 市 点 之 
间 的 边线 是 没有 方 癌 的: 节点 A 和 C 之 间 的 边线 可 以 是 从 A 至 C, 也 可 以 是 从 C 至 A, 图 中 其 他 边线 
也 一 样 是 无 回 的 。 














图 2-6 图形 由 用 边线 连接 起 来 的 节点 组 成 


而 图 2-7 展 示 的 图 则 是 有 向 图 ( directed graph， 即 digraph )。 其 中 节点 间 的 边线 一 端 都 有 代表 
方向 的 箭头 符号 : 节点 A 和 C 之 间 边 线 的 方向 是 从 A 到 C 的 ， 而 不 是 从 C 到 A 的 。 
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图 在 软件 工程 的 很 多 领域 都 有 很 好 的 应 用 , 但 是 它 更 适合 用 来 对 代码 间 的 依赖 关系 建 模 。 前 
面 几 市 已 经 讲解 了 , 一 个 依赖 关系 包含 了 两 个 不 同 的 代码 实体 , 它们 之 间 的 联系 方向 是 从 依赖 者 
到 被 依赖 者 。 你 可 以 把 实体 看 作 节 点 ， 并 从 依赖 者 到 被 依赖 者 的 方向 绘制 有 向 边线 。 反 复 在 所 有 
其 他 实体 上 应 用 节点 和 有 辐 边 线 的 概念 进行 建 模 ， 你 就 能 得 到 一 个 完整 的 依赖 有 向 图 
(dependency digraph )。 











图 2-7 ”这 个 图 中 的 边线 是 标明 了 方向 的 ， 所 以 只 有 A 到 B 的 有 回 边 线 ， 而 没有 B 到 A 的 
有 问 边 线 


如 图 2-8 所 示 ， 可 以 在 项 目的 不 同 层次 上 应 用 这 种 依赖 关系 的 建 模 方式 。 图 中 节点 可 以 用 来 
表达 项 目 中 的 类 、 程 序 集 或 者 子 系统 中 的 程序 集 组 。 无 论 在 哪个 层次 上 ， 节 点 间 边 线 的 箭头 都 表 
达 了 不 同 组 件 之 间 的 依赖 关系 。 季 涉 从 依赖 组 件 指 癌 被 依赖 组 件 。 

每 个 大 粒度 的 节点 都 可 以 分 解 成 为 一 组 更 小 粒度 的 节点 。 比 如 : 子 系统 可 以 分 解 为 一 组 程序 
集 ; 程序 集 可 以 分 解 为 一 组 类 ; 类 内 部 仍 可 以 分 解 为 一 组 方法 。 图 2-8 这 个 示例 展示 了 在 整个 子 
系统 依赖 链 中 一 个 单独 方法 上 依赖 关系 所 处 的 位 置 。 

然而 ， 上 面 所 有 的 示例 只 能 展示 出 有 依赖 关系 ,但 是 并 没有 展示 出 依赖 的 分 类 ( 比如 继承 、 
聚合 、 复 合 以 及 关联 )。 但 是 这 依然 是 有 用 的 ， 因 为 依赖 关系 只 需要 知道 两 个 二 进 制 实体 之 间 的 
关系 : 有 或 没有 依赖 ? 

循环 依赖 

图 论 中 还 提 到 有 癌 图 中 会 形成 循环 , 也 就 是 说 从 一 个 节点 沿 厦 有 问 边 线 遍 历 后 还 能 够 回 到 这 
个 节点 。 前 面 几 节 中 展示 的 图 都 没有 循环 ， 称 为 有 向 无 环 图 (acyclic digraph )。 图 2-9 展 示 了 一 个 
有 向 有 环 图 (cyclic digraph ) 的 示例 。 从 节点 D 开 始 ， 可 以 沿 着 边线 经 过 节点 E 和 B， 最 后 又 回 到 
万 点 D。 

如 果 用 节点 表示 程序 集 。 图 中 程序 集 D 显 式 或 隐 式 地 依赖 一 些 程序 集 ， 因 此 它 也 隐 式 依赖 这 
些 程序 集 所 依赖 的 其 他 一 些 程序 集 。 上 面 图 表 中 ， 节 点 DD 显 式 依 赖 节 点 E， 隐 式 依赖 市 点 B 和 D， 
因此 节点 D 也 依赖 自身 。 
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互联 网 提供 很 多 服务 ， 设 备 是 它 的 客户 


包 (包括 程 sn 上 间 ] ) 
客户 也 是 服务 


eee 


服务 类 是 由 客户 端 类 使 用 的 





Sessyl sm 


有 些 服务 会 隐藏 在 接口 后 面 


public void ClientO 
{ 


int x = 6; 


Console.WriteLine("{0}! = {1}", Service(x)); 


即使 在 方法 级 别 上 ， 调 用 另 一 个 方法 的 方法 也 


是 服务 的 客户 端 





3 dd E Ee 


图 2-8 各 个 级 别 的 依赖 都 可 以 使 用 图 形 来 建 模 





图 2-9 ”这 个 有 向 图 包含 多 个 
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如 果 节 点 是 程序 集 ， 这 种 循环 依赖 是 不 可 能 出 现 的 。 不 允许 在 Visual Studio 中 尝试 构建 这 种 
循环 依赖 关系 。 在 项 目 E 中 添加 对 B 程 序 集 的 引用 时 ， 会 看 到 如 图 2-10 所 示 的 警告 信息 。 


Microsoft Visual Studio Express 2012 for Windows Desktop EI 


A reference to 'B' could not be added. Adding this project as a reference 2 


~ 
3 would cause a circular dependency. 














ee 








图 2-10 不 人 允许 在 visual Studio 中 创建 循环 依赖 关系 


尽管 使 用 图 对 依赖 关系 进行 建 模 似乎 有 点 太 过 学 术 , 但 是 这 样 组 织 依赖 关系 还 是 很 有 好 处 

的 。 理 论 上 ， 可 以 存在 的 循环 依赖 关系 在 软件 工程 的 实际 应 用 中 完全 不 允许 ， 而 且 一 定 要 避免 。 
了 种 特殊 的 循环 叫 作 自 循环 (1loop )。 如 果 节 点 通过 一 条 边线 直接 连接 自身 ， 那 
这 条 边线 就 变 成 了 一 个 自 循环 。 图 2-11 展 示 了 带 有 一 个 自 循环 的 有 向 图 。 


» 
0, 


图 2-11 这 个 有 向 图 中 ， 节 点 B 通 过 一 个 自 循环 连接 到 自身 


实际 应 用 中 ,程序 集 通 常 都 是 显 式 自 依赖 的 ， 这 一 点 通常 不 会 被 注意 到 。 此 外 ,方法 层 的 递 
归 (recursion ) 就 是 一 个 很 好 的 上 自 循 环 的 例子 ， 如 代码 清单 2-4 所 示 。 


代码 清单 2-4 ”有 癌 图 中 的 日 循环 可 以 用 来 表示 递归 方法 


namespace Graphs 








{ 
public class RecursionLoop 
{ 
public void AGO 
{ 
Te SS (05 
Console.WritelLine("{0}! = {1}", x, B(xX)); 
} 


public int BCint number) 
{ 
if(number == 0) 
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{ 
return 1; 
} 
else 
{ 
return number * BCnumber - 1); 
} 


} 


代码 清单 2-4 中 的 类 与 图 2-11 中 的 依赖 图 表达 了 相同 的 功能 。 方 法 A 调用 了 方法 B， 那 么 方法 
A 依赖 方法 B。 然而 ,更 有 趣 的 是 递归 方法 B, 它 显 式 地 依赖 日 向 。 递归 方 法 就 是 一 个 调用 自 号 的 
方法 ei 
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现在 你 已 经 知道 ， 依 赖 关 系 是 必要 的 ,但 是 必须 小 心 管理 以 免 产 生 的 问题 影响 了 后 期 开发 。 
通常 ， 当 这 些 问题 暴 露出 来 时 ,就 已 经 很 难 解决 了 。 因 此， 最 好 从 一 开始 就 着 慎 正确 地 管理 所 有 
依赖 关系 ,以 免 不 经 音 间 引入 问题 。 糟糕 管理 的 依赖 关系 引起 的 微小 局 部 问题 会 很 快 升级 为 项 目 
整体 架构 上 的 严重 问题 。 

本 章 剩 余 几 节 会 更 多 地 集中 讲解 如 何 持续 管理 依赖 〈 包 括 避 免 反 模式 )， 更 重要 的 是 ， 要 理 
解 为 何 有 些 稼 见 的 模式 是 反 模 式 。 相 反 ， 有 些 模式 是 真 的 有 益 并 值得 推广 的 ,它们 可 以 用 来 蔡 代 
相应 的 反 模 式 。 

















模式 和 反 模 式 

软件 工程 历史 上 ， 面向 对 象 软件 开发 算是 个 相对 比较 新 的 尝试 。 在 过 去 的 几 十 年 里 ， 已 
经 有 一 些 类 和 接口 间 的 协作 方法 被 识别 和 总 结 出 来 ， 它 们 是 可 重用 的 ， 并 称 之 为 模式 
(pattern )。 

软件 开发 模式 有 很 多 种 ,每 种 模式 都 可 以 在 某 些 特定 的 问题 域 重 复 应 用 。 有 些 模式 协同 
其 他 一 些 模式 后 还 能 够 为 复杂 问题 提供 优雅 的 解决 方案 。 当 然 ， 并 不 是 所 有 模式 总 是 可 应 用 
的 ， 需 要 花费 时 间 进 行 实践 并 积累 经 验 ， 才 能 识别 出 应 用 这 些 模式 的 合适 场合 。 

有 些 模式 并 没有 多 少 益处 ， 相 反 它 们 实际 上 还 有 很 多 副作用 ， 这 类 模式 被 称 为 反 模 式 
( anti-pattern )。 反 模式 会 破坏 代码 的 自 适应 能 力 ， 应 该 避免 在 代码 中 引入 它们 。 随 着 很 多 副 
作用 被 发 现 ， 一 些 模式 会 逐渐 被 抛弃 并 归 类 为 反 模 式 。 


2.2.1 ”实现 与 接口 
通常 ， 对 于 刚刚 接触 面向 接口 编程 概念 的 开发 人 员 而 言 , 不 让 他 们 去 考虑 接口 后 面 的 实现 细 
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节 会 很 困难 。 

编译 时 , 接口 的 所 有 客户 端 都 不 应 该 知道 接口 要 使 用 的 具体 实现 。 如 果 知 道具 体 实现 , 会 让 
人 错误 地 认为 客户 端 代码 与 接口 的 这 个 具体 实现 是 直接 关联 的 。 

考虑 一 个 常见 的 例子 : 一 个 类 能 够 向 永久 存储 介质 中 存放 记录 数据 。 为 了 达到 这 个 目的 , 正 
确 的 做 法 是 定义 一 个 隐藏 具体 永久 存储 机 制 细 闻 的 接口 。 另 外 切记 , 不 要 假设 运行 时 会 使 用 某 种 
具体 的 实现 。 比 如 ， 不 要 在 代码 中 将 接口 转换 为 任何 具体 实现 。 

















2.2.2 new 代码 味道 


接口 描述 能 做 什么 ,接口 的 实现 类 则 描述 如 何 做 。 只 有 类 才 会 涉及 实现 细节 , 接口 应 该 对 如 
何 实 现 的 细节 一 无 所 知 。 这 是 因为 只 有 类 才 有 构造 也 数 ,构造 函数 则 包含 了 实现 细 方 。 在 此 基础 
上 会 得 到 一 个 有 意思 的 结论 ， 那 就 是 ， 除 了 一 些 特殊 情况 外 ， 几 是 出 现 new 关 键 字 的 地 方 都 是 代 
码 味道 ( code smell )。 











代码 味道 

如 果菜 段 代码 可 能 存在 问题 ,就 可 以 说 有 代码 味道 这 里 使 用 “可 能 ”是 因为 少量 的 代 
码 味道 并 不 一 定 就 是 问题 。 反 模式 总 被 认为 是 坏 的 实践 ,但 代码 味道 不 一 样 ， 它 们 不 一 定 是 
坏 的 实践 。 代 码 味 道 可 以 警告 可 能 有 错误 发 生 ， 需 要 根据 根本 原因 来 判断 是 否 要 修正 。 

代码 味道 还 可 能 表明 有 技术 债务 存在 , 而 技术 债务 的 修复 是 有 代价 的 。 背 负 技 术 债 务 越 
久 ， 债 务 修复 就 会 越 难 。 

代码 味道 有 很 多 分 类 , 使 用 关键 字 new 创 建 对 象 实例 属于 “ 独 昵 关系 ”。 因 为 构造 函数 是 
实现 细节 ， 客 户 端 代码 调用 构造 函数 会 引入 意外 的 (也 是 不 布 望 的 ) 依赖 关系 。 

与 反 模 式 一 样 ， 可 以 通过 重 构 代码 来 清除 代码 味道 ， 重 构 后 的 代码 有 着 更 好 的 、 更 具有 
适应 能 力 的 设计 。 实现 了 次 优 设计 的 代码 可 能 满足 了 当前 的 需求 , 但 是 将 来 还 是 可 能 会 引起 
问题 。 代码 重 构 无 疑 是 一 个 无 法 立即 产生 可 见效 益 的 开发 任务 ,因为 所 有 修复 问题 的 重 构 工 
作 都 不 会 附加 有 相应 的 业务 价值 。 然而 ,与 金融 债务 可 能 导致 支付 高 额 利 息 类 似 , 技术 债务 
也 有 可 能 会 逐渐 失去 控制 ,进而 摧毁 良好 的 依赖 管理 实践 ,危及 后 续 的 代码 设计 改进 和 问题 


修复 。 
代码 清单 2-5 展 示 了 使 用 new 关 键 字 的 代码 味道 ， 两 个 例子 都 直接 创建 了 对 象 实例 。 
代码 清单 2-5 一 个 示例 ， 展 示 如 何 通 过 实例 化 对 象 来 破坏 代码 的 适应 能 力 


public class AccountController 


{ 





private readonly SecurityService securityService; 


public AccountControllerQO 
{ 


this.securityService = new SecurityService() ; 
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} 


[HttpPost] 

public void ChangePassword(Guid userID, string newPassword) 

{ 
var userRepository = new UserRepositoryQO; 
var user = userRepository.GetByID(userID); 
this.securityService.ChangeUsersPassword(user, newPassword); 





AccountController 类 是 从 一 个 假定 的 ASPNET MVCA 我 们 先 抛 开 该 类 
的 实现 细 市 , 痢 重 看 看 这 些 加 粗 的 不 恰当 的 对 象 构造 语句 。 这 个 控制 需 类 的 职责 是 允许 用 户 执行 
账户 查询 和 其 他 命令 。 这 个 示例 中 只 展示 了 一 个 命令 : ee 

代码 中 有 下 面 一 些 问 题 ， 这 些 问题 是 由 于 两 个 显 式 调 用 new 关 键 字 的 构造 对 象 实例 引起 的 。 

口 AccountContro11er 类 永远 依赖 SecurityService 类 以 及 UserRepository 类 的 具体 实现 。 

口 AccountController 类 隐 式 依赖 SecurityService 类 和 UserRepository 类 的 所 有 依赖 。 

口 AccountContro11er 类 很 难 测 试 ， 因 为 无 法 用 伪 实 现 来 模拟 和 替代 SecurityService 类 

TSG rR Do IE 
口 SecurityService 类 的 ChangeUsersPassword 方 法 需要 客户 端 代码 先 加 载 好 User 类 的 
实例 对 象 。 
会 详细 削 析 这 几 个 问题 。 

1. 无 法 增强 实现 

当 你 想 要 改变 SecruityService 类 的 实现 时 , 只 有 两 个 选择 , 要 么 改动 AccountController 
来 直接 引用 新 的 实现 , 要 么 给 现 有 的 SecurityService 添 加 新 功能 。 阅 读本 书 之 后 ,你 会 发 现 这 
两 个 选项 都 不 好 。 现 在 ， 我 们 先 把 目标 定 为 AccountController 和 SecurityService 在 创建 后 
都 不 允许 再 做 任何 改动 。 

2. 依赖 关系 链 

SecurityService 类 也 会 有 自己 的 依赖 关系 。 代 码 清单 2-5 中 ， 加 粗 的 SecurityService 类 
的 默认 构造 函数 看 起 来 似乎 没有 任何 依赖 。 但 是 , 如 果 SecurityService 类 的 构造 负 数 的 实现 如 
下 面 的 代码 清单 2-6 所 示 呢 ? 


代码 清单 2-6 ”SecurityService 和 AccountController 两 个 类 有 着 同样 的 问题 


public SecurityService() 


{ 


this.Session = SessionFactory.GetSession(); 


} 





























SecurityService 类 实际 上 依 阁 NHibernate ( 一 种 对 象 /关系 映射 器 ) 库 ， 它 被 用 来 获取 一 
会 话 (session )。NHibernate 使 用 会 话 来 表示 指 向 持久 关系 型 存储 ( 比如 Micorsoft SQL Server、 
0 的 连接 。 正 如 前 面 所 讲 的 ， 这 意味 着 AccountController 类 也 隐 式 依赖 
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NHibernate 库 。 

再 者 ， 如 果 SecurityService 类 的 构造 疯 数 签名 也 要 改变 呢 ?” 也 就 是 说 ， 如 有 果 Security- 
Service 类 的 构造 函数 突然 需要 客户 端 代码 提供 数据 库 连 接 字 符 串 给 会 话 呢 ?任何 使 用 
SecurityService 类 的 客户 ， 包 括 AccountController 类 在 内 ， 都 必须 改动 代码 来 提供 连接 字 2 
符 串 。 再 强调 一 次 ， 一 定 要 避免 这 种 糟糕 的 变更 。 

3. 缺乏 可 测试 性 

可 测试 性 也 非常 重要 ， 它 需要 代码 以 一 定 的 模式 构建 。 如 果 不 这 样 做 ， 测 试 将 变 得 极其 困 
难 。 不 幸 的 是 ， 在 代码 清单 2-$ 中 ，AccountContro11er 和 SecurityServj et 
测试 ， 因 为 你 无 法 使 用 不 执行 任何 动作 的 模拟 实现 来 替代 这 两 个 类 的 实现 。 举 个 例子 ， 在 测试 
SecurityService 类 时 ， 你 并 不 想 建立 到 数据 库 的 连接 。 因 为 连接 数据 库 的 过 程 不 仅 慢 也 没有 
必要 ， 而 且 还 会 引入 另外 一 个 更 高 失败 率 的 测试 点 : 连接 数据 库 失 败 。 有 几 种 方法 可 以 在 运行 
时 使 用 模拟 实现 来 替代 对 这 两 个 类 的 依赖 。 诸 如 Microsoft Moles 和 Typemock 之 类 的 工具 可 以 多 
人 构造 函数 中 ， 并 确保 它们 返回 的 对 象 是 Fakes。 但 是 ， 这 些 方法 要 谨慎 使 用 ， 因 为 它们 只 能 治 
标 但 不 能 治本 。 

4. 更 多 的 独 昵 关系 

AccountController 类 的 Change as rd 方法 会 完 创建 一 个 Use rRepository 类 的 实例 ， 
然后 通过 它 获 取 一 个 User 类 的 实例 。 它 这 样 做 的 唯一 原因 就 是 SecurityService 类 的 
ChangePassword 方 法 的 需要 。 ee 的 实例 ， 就 无 法 调用 该 方法 ， 这 也 表明 
这 个 方法 的 签名 设计 很 糟糕 。 如 果 所 有 客户 端 代码 都 需要 获取 一 个 User 类 的 实例 ， 这 种 情况 下 ， 
SecurityService 类 就 应 该 在 自己 内 部 获取 User 类 的 实例 。 代 码 清 单 2-7 展 示 了 重 构 后 用 于 更 改 
用 户 密码 的 两 个 方法 。 


代码 清单 2-7 ”对 客户 调用 SecurityService 类 代码 的 一 个 改进 


[HttpPost] 
public void ChangePassword(Guid userID, string newPassword) 


{ 

















this.securityService.ChangeUsersPassword(userID, newPassword); 
} 
二 
public void ChangeUsersPassword(Guid userID，string newPassword) 
{ 
var UserRepository = new UserRepository() ; 
var User = userRepository.GetByID(userID); 
user.ChangePassword(newPassword); 


} 


对 于 AccountController 类 而 言 ， 这 绝对 是 个 改进 ,但 是 ChangeUsersPassword 方 法 仍然 
会 直接 实例 化 UserRepository 类 。 
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2.2.3 对象 构 造 的 替代 方法 


怎么 做 才 可 以 同时 改进 AccountController 和 SecurityService 这 两 个 类 ,或 者 其 他 任何 
不 合适 的 对 象 构造 调用 呢 ? 如 何 才 能 正确 设计 和 实现 这 两 个 类 以 避免 出 现 上 节 所 讲述 的 任何 问题 
呢 ? 下 面 有 一 些 能 够 互补 的 方式 可 供 选 择 。 

1. 针对 接口 编码 

你 应 该 做 的 首要 改动 是 将 SecurityService 类 的 实现 隐藏 在 一 个 接口 后 。 这 样 
AccountController 类 就 会 只 依赖 SecurityService 类 的 接口 而 不 是 它 的 具体 实现 。 第 一 个 代 
人 码 重 构 就 是 为 SecurityService 类 提取 一 个 接口 ， 如 代码 清单 2-8 所 示 。 


代码 清单 2-8 为 SecurityService 类 提取 一 个 接口 


public interface ISecurityService 








{ 
void ChangeUsersPassword(Guid userID, string newPassword); 
} 
/A 
public class SecurityService : ISecurityService 
{ 
public ChangeUsersPassword(Guid userID, string newPassword) 
{ 
AR 
} 
} 


下 一 步 就 是 改动 客户 端 代码 来 调用 ISecurityService 接 口 ， 而 不 是 SecurityService 类 。 
代码 清单 2-9 展 示 了 应 用 这 个 重 构 后 的 AccountController 类 的 情况 。 


代码 清单 2-9 AccountController 类 现在 依赖 ISecurityService 接 口 


public class AccountController 





{ 
private readonly ISecurityService securityService; 
public AccountController() 
{ 
this.securityService = new SecurityService(); 
} 
[HttpPost] 
public void ChangePassword(Guid userID, string newPassword) 
{ 
securityService.ChangeUsersPassword(user, newPassword); 
} 
} 


这 个 示例 仍然 没有 结束 , 因为 依然 直接 调用 了 SecurityService 类 的 构造 水 数 , 所 以 重 构 后 
的 AccountController 类 依然 依赖 SecurityService 类 的 具体 实现 。AccountController 类 的 
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构造 函数 还 是 会 实例 化 具体 的 SecurityService 类 实例 。 要 将 这 两 个 具体 类 完全 解 耦 , 你 还 需要 
作 进 一 步 的 重 构 ， 即 引入 依赖 注入 (Dependency Injection，DI )。 

2. 使 用 依赖 注入 

这 个 主题 比较 大 ， 无 法 用 很 短 的 篇 幅 讲 完 。 实 际 上 ， 第 9 章 会 专门 讲解 这 个 主题 ， 此 外 还 有 
一 些 依赖 注入 的 专题 书籍 。 笠 运 的 是 , 依赖 注入 并 不 是 很 复杂 或 者 困难 ， 所 以 本 节 会 从 使 用 依赖 
注入 的 类 的 角度 来 讲解 一 些 基 本 的 要 点 。 代 码 清单 2-10 展 示 了 新 的 对 AccountContro11er 类 的 构 
造 明 数 进行 的 代码 重 构 。 重 构 后 的 构造 隐 数 代码 部 分 已 经 加 粗 显示 , 重 构 动作 的 改动 非常 小 , 但 
是 管理 依赖 的 能 力 却 大 不 相同 。AccountController 类 不 再 要 求 构 造 SecurityService 类 的 实 
例 ， 而 是 要 求 它 的 客户 端 代码 提供 一 个 ISecurityService 接 口 的 实现 。 不 仅 如 此 ， 构 造 函 数 中 
还 加 入 了 前 置 条 件 的 检查 语句 , 用 于 防止 从 securityService 参 数 上 传人 空 值 的 异常 情况 。 这 个 
检查 确保 了 ， 在 ChangePassword 方 法 中 需要 使 用 securityService 类 的 实例 时 ， 该 实例 始终 有 
效 量 无 需 处 处 检查 空 值 。 


代码 清单 2-10 ”使 用 依赖 注 和 人 从 AccountController 类 中 移 除 对 SecurityService 类 的 依赖 


public class AccountController 


{ 








private readonly ISecurityService securityService; 


public AccountController(ISecurityService securityService) 
1 


if(securityService == null) throw new ArgumentNullException("securityService"); 


this.securityService = securityService; 


} 


[HttpPost] 
public void ChangePassword(Guid userID, string newPassword) 


{ 


this.securityService.ChangeUsersPassword(user, newPassword); 


} 


SecurityService 类 也 同样 需要 应 用 依赖 注入 。 代 码 清 单 2-11 展 示 了 重 构 后 的 类 实现 。 
代码 清单 2-11 依赖 注入 是 一 种 很 常见 的 模式 ， 几 乎 可 以 不 受 限 制 地 应 用 于 代码 中 的 任意 位 置 


public class SecurityService : ISecurityService 


{ 


private readonly IUserRepository userRepository; 


public SecurityService(IUserRepository userRepository) 

{ 
if(userRepository == nul1) throw new ArgumentNullException("userRepository"); 
this.userRepository = userRepository; 
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public ChangeUsersPassword () 

{ 
var user = userRepository.GetByID(userID); 
user.ChangePassword(newPassword); 


} 


与 AccountController 类 改 为 依赖 一 个 有 效 的 ISecurityService 接 口 实例 一 样 ， 
SecurityService 类 也 改 为 依赖 一 个 有 效 的 IUserRepository 类 的 实例 (构造 函数 在 检测 到 传 
入 的 是 空 值 时 会 引发 异常 )。 同样 地 ， 通 过 引入 IUserRepository 接 口 ，SecurityService 类 对 
UserRepository 类 的 依赖 也 被 全 部 移 除 了 。 


2.2.4 随从 反 模 式 


随从 反 模 式 (entourage anti-pattern ) 这 个 名 称 缘 于 这 样 的 事实 : 即使 你 只 想 要 个 简单 的 东西 ， 
也 总 是 会 得 到 包括 它 在 内 的 很 多 东西 。 就 像 歌星 或 电影 明星 一 样 ， 他 们 总 是 带 着 他 们 的 随从 (中 
班 或 助理 之 类 的 人 ) 一 同 进 进出 出 。 这 是 我 为 这 种 模式 起 的 名 称 , 用 于 更 恰当 地 表达 这 些 并 不 需 
要 的 依赖 关系 。 

随从 反 模 式 是 开发 人 员 使 用 针对 接口 编程 时 很 容易 犯 的 一 个 错误 。 无 需 缆 述 , 这 里 要 直接 给 
出 的 结论 是 : 接口 和 接口 的 依赖 项 肯定 不 应 该 布置 在 同一 个 程序 集 内 。 

图 2-12 中 的 UML 图 展示 了 AccountController 示 例 中 包 层 次 上 的 组 织 关系 。 
AccountController 类 依赖 ISecurityService 接 口 , 后 者 则 由 SecurityService 类 实现 , 图 中 
的 包 ( .NET 程 序 集 或 者 Visual Studio 项 目 ) 就 是 依赖 关系 中 实体 的 容 右 。 图 2-12 就 是 一 个 随从 反 


























模式 的 例子 : 接口 本 映 和 接口 的 实现 类 被 布局 在 同一 个 程序 集 内 。 


<<|NTERFACE> > 
Accou ntController pe 一 中 ISecu rityService 
+ChangeUsersPassword 


Services 





+ChangePassword 


SecurityService 
图 2-12 AccountController 类 所 在 的 程序 集 依赖 Services 程 序 集 


相信 你 已 经 知道 ,SecurityService 类 也 有 自己 的 一 些 依赖 关系 , 依赖 关系 链 也 会 导致 客户 
端 之 间 的 隐 式 依赖 。 通 过 扩展 包 图 ， 图 2-13 展 示 了 一 个 完整 的 随从 问题 。 








邮 
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Controllers 


AccountController 


<<INTERFACE> > 
IUserRepository 





图 2-13” ”AccountController 类 依然 隐 式 依 束 了 太 多 的 实现 


如 果 你 单独 构建 Controllers 项 目 ， 会 发 现 bin 目 录 下 也 会 有 NHibernate 程序 集 ， 这 表明 了 
Controllers 程 序 集 依 然 隐 式 依赖 了 NHibernate 程序 集 。 此 时 ， 尽 管 你 已 经 通过 多 次 重 构 移 除 了 
AccountControl11er 类 中 那些 不 必要 的 依赖 关系 ， 但 是 它 与 每 个 要 依赖 程序 集 的 实现 之 间 依 然 
不 是 松散 耦合 的 关系 。 
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随从 反 模 式 会 市 来 两 个 问题 。 第 一 个 问题 与 开发 人 员 的 自律 有 关 。 每 个 包 ( Services、Domain 
和 NHibernate ) 都 要 有 设置 为 pub1ic 的 接口 定义 。 然 而 , 你 还 需要 实现 具体 的 类 并 标记 为 pub1ic， 
因为 你 总 是 要 在 某 些 地 方 构造 接口 实现 类 的 实例 ( 只 是 不 要 在 客户 端 类 中 直接 调用 )。 这 就 意味 
着 不 够 日 律 的 开发 人 员 仍 然 可 以 直接 引用 具体 实现 。 很 多 人 都 会 走 “ 捷 径 ” 去 直接 调用 new 关 键 
字 来 获取 接口 实现 类 的 实例 。 

第 二 个 问题 ， 如 果 你 准备 创建 一 个 新 的 SecurityService 实 现 类 ， 它 不 依赖 使 用 NHibernate 
程序 集 的 Domain 模 型 ， 而 是 使 用 一 个 第 三 方 服务 总 线 (比如 NServiceBus ) 来 给 句柄 发 送 命令 消 
息 呢 ? 把 这 个 新 的 实现 加 入 到 Services 程 序 集 里 仍然 会 引入 对 NServiceBus 的 依赖 ， 不 断 膨胀 的 代 
码 库 会 变 得 更 加 脆弱 ， 很 难 适 应 后 期 的 新 需求 。 

有 个 常用 的 规则 就 是 把 接口 的 实现 与 接口 本 刁 拆 分 开 , 分 别 布置 在 不 同 的 程序 集中 。 可 以 使 
用 下 节 要 讲解 的 阶梯 模式 来 拆 分 接口 和 相应 的 实现 类 。 


2.2.5 ”阶梯 模式 


阶梯 模式 是 一 种 正确 组 织 类 和 接口 的 方法 。 因 为 接口 和 接口 的 实现 类 布置 在 不 同 的 程序 集 
内 ， 二 者 可 以 独立 更 改 ， 客 户 端 代 码 始终 只 需要 引用 接口 所 在 的 程序 集 。 

你 可 能 会 想 :“ 这 样 做 会 产生 多 少 程序 集 啊 ? 如 果 需 要 把 每 个 接口 和 类 都 拆 分 到 自己 独 有 的 
程序 集 内 ， 一 个 解决 方案 会 不 会 包含 两 百 个 项 目 啊 !” 不 用 担心 ， 因 为 应 用 阶梯 模式 只 会 增加 少 
量 的 项 目 , 同时 叉 能 让 解决 方案 的 结构 始终 保持 清晰 明了 。 如 果 项 目的 组 织 很 糟糕 , 通过 应 用 阶 
梯 模 式 来 减少 项 目 总 体 数目 是 有 一 定 效 果 的 。 

可 以 应 用 阶梯 模式 再 次 重 构 前 面 的 AccountController 示 例 ， 图 2-14 展 示 了 这 次 重 构 的 结 
果 。 每 个 实现 ,也 就 是 每 个 类 ， 只 引用 要 依赖 接口 所 在 的 程序 集 ， 它 不 会 显 式 或 隐 式 地 引用 接口 
实现 所 在 的 程序 集 。 每 个 实现 类 也 会 引用 自己 接口 所 在 的 程序 集 。 阶 梯 模 式 的 组 织 方式 好 处 很 多 : 
接口 没有 任何 依赖 , 调用 接口 的 客户 端 代码 也 不 会 有 任何 隐 性 依赖 , 接口 的 实现 也 同样 只 依赖 其 
他 仅 包 含 接 口 的 程序 集 。 

这 里 , 我 想 再 详细 强调 阶梯 模式 的 好 处 之 一 : 接口 不 应 该 有 任何 外 部 依赖 。 开 发 人 员 要 尽量 
坚持 好 这 个 原则 。 接 口 的 方法 和 属性 不 应 当 暴 露出 任何 第 三 方 引用 中 定义 的 数据 对 象 或 类 。 尽 管 
接口 可 以 (也 一 定 会 需要 ) 依赖 同一 解决 方案 下 的 其 他 项 目 以 及 常见 的 .NET Framework 库 定义 的 
类 , 但 是 应 该 避免 对 基础 构件 实体 的 依赖 。 第 三 方 库 通 常 都 是 用 来 提供 基础 构件 的 。 即 使 使 用 的 
是 第 三 方 库 (比如 Log4Net、NHibernate 和 MongoDB 等 ) 的 接口 ， 你 的 接口 依然 会 与 库 的 实现 绑 
定 在 一 起 。 这 是 因为 这 些 第 三 方 库 的 包 都 应 用 了 随从 反 模 式 ， 而 不 是 阶 樟 模式。 它们 都 只 提供 了 
单个 程序 集 ， 其 中 既 包 含 了 需要 依赖 的 接口 ， 也 包含 了 不 希望 依赖 的 实现 。 

为 了 避免 这 个 问题 ， 可 以 引用 用 于 记录 日 志 、 域 持久 化 和 文档 存储 的 自 定 义 接 口 。 你 的 简单 
接口 可 以 把 对 第 三 方 的 依赖 隐藏 在 对 第 一 方程 序 集 的 依赖 后 面 。 如 果 后 面 需 要 更 换 对 第 三 方 的 依 
赖 ， 只 需要 为 更 换 后 的 新 接口 编写 一 个 新 的 适配器 就 可 以 。 
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Controllers Servicelnterfaces 


<<|NTERFACE> > 
AccountController [ -|--r»| ISecurityService 
+ChangeUsersPassword 
1 


ServicesImplementations 


SecurityService | 










+ChangePassword() 


<<INTERFACE>> 
IUserRepository 
+GetBylD 
1 


I 
NHibernate 


<<INTERFACE>> 
UserRepository -|-- J»||session 


+GetBylD +Get 















+ChangeUsersPassword 









Session 


+Get 


图 2-14 阶梯 模式 的 名 称 恰当 地 摘 述 了 应 用 该 模式 后 形成 的 包 结构 


从 实际 应 用 的 角度 来 看 , 为 所 有 第 三 方 引用 都 编写 适配器 和 接口 并 不 现实 ,如 果 工作 量 很 大 ， 
开发 团队 应 当 认 识 到 项 目 不 得 不 保持 对 第 三 方程 序 集 的 依赖 ， 这 种 依赖 还 会 慢 慢 渗透 到 整个 项 
目 。 第 三 方 库 的 规模 越 大 ,替换 它 就 越 难 ， 耗 时 也 会 越 长 。 相 比 单个 巨型 第 三 方 库 的 更 好 选择 应 
该 是 框架 ， 后 者 比 前 者 的 规模 大 得 多 。 


2.2.6 ”依赖 解析 


只 知道 如 何 组 织 项 目 和 相关 依赖 对 调试 运行 时 程序 集 间 依赖 并 没有 多 大 帮助 。 有 时 候 程 序 集 
在 运行 时 并 不 可 用 ， 这 就 需要 找 出 根本 的 原因 。 

1. 程序 集 

公共 语言 运行 时 ( Common Language Runtime，CLR ) 是 .NET Framework 用 来 执行 代码 指令 
的 虚拟 机 。 它 也 是 一 个 软件 产品 ， 作 为 .NET 应 用 程序 的 宿主 ， 它 以 一 种 可 预测 的 符合 逻辑 的 方 
式 运 行 。 清 楚 程 序 集 依赖 以 及 修复 方案 的 理论 和 实践 都 会 很 有 用 。 如 果 知 之 甚 少 , 在 需要 诊断 程 
序 集 问题 时 可 能 会 走 些 变 路 。 

@ 解析 流程 

程序 集 解 析 流 程 在 公共 语言 运行 时 中 很 重要 。 引 用 程序 集 或 项 目 后 , 在 运行 时 加 载 程序 集 前 
就 需要 解析 程序 集 。 这 个 流程 包括 几 个 步骤 ， 期 间 如 果 出 错 ， 你 可 以 诊断 问题 可 能 的 原因 。 

图 2-15 以 流程 图 的 形式 展示 了 程序 集 解 析 的 过 程 。 这 个 流程 图 只 是 个 没有 包含 所 有 细节 的 高 
层 框 架 , 但 是 用 来 展示 流程 的 要 点 已 经 足够 了 。 流 程 步 骤 如 下 所 示 。 
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口 公共 语言 运行 时 使 用 即时 (just-in-time，JIT ) 模型 来 解析 程序 集 。 正 如 本 章 开 始 几 节 已 
证 实 的 那样 ， 启 动 应 用 时 是 不 会 解析 应 用 中 包含 的 引用 的 ， 而 是 直到 首次 使 用 程序 集 的 


某 个 特性 时 才 会 解析 应 用 中 包含 的 引用 ( 真 的 是 即时 解析 )。 
Ey 





开始 解析 







查 明 程序 集 版 本 












是 否 尝试 
过 解析 ? 





全 局 程序 集 缓 存 






解析 失败 已 找到 


使 用 已 加 载 pe 
的 程序 集 解析 成 功 


图 2-15 ”程序 集 解析 流程 的 概要 图 


口 每 个 程序 集 都 有 一 个 标识 符 ， 它 们 由 程序 集 名 称 、 版 本 、 文 化 和 公 钥 令 牌 组 合 构成 。 诸 
如 绑 定 重 定 同等 特性 可 以 改变 程序 集 的 标识 符 ， 所 以 确定 标识 符 也 不 像 看 起 来 那么 容易 。 

口 当 程 序 集 标 识 符 确 定 后 ， 在 当前 应 用 程序 执行 期 间 ， 公 共 语 言 运行 时 能 够 决定 是 否 已 经 
尝试 解析 过 依赖 。 下 面 这 个 Visual Studio 项 目 文件 内 容 片 段 展示 了 引用 的 标识 信息 。 


<reference include="MyAssembly, Version=2.1.0.0, Culture=neutral, 
PublicKeyToken=17fac983cbea459c™" /> 


口 公共 语言 运行 时 会 根据 是 否 已 经 党 试 过 解析 来 走 不 同 的 分 文 。 如 采 已 经 党 试 过 解析 该 程 
序 集 ， 那 么 解析 过 程 要 么 成 功 要 么 失败 。 如 果 解 析 成 功 了 ， 公 共 语 言 运 行 时 会 使 用 已 经 
加 载 的 有 效 程序 集 。 如 果 解 析 失 败 了 ， 公 共 语 言 运行 时 会 知道 自己 无 需 再 尝试 解析 了 ， 
因为 一 定 会 失败 。 
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口 或 者 ， 如 有 果 是 第 一 次 尝试 解析 该 程序 集 ， 公 共 语 言 运 行 时 会 首先 检查 全 局 程序 集 缓存 
(Global Assembly Cache，GAC )。 全 局 程序 集 绥 存 是 一 个 整个 机 器 可 见 的 程序 集 库 ,， 它 允 
许 同 一 个 程序 集 的 不 同 版 本 在 同一 个 应 用 程序 上 执行 。 如 果 在 全 局 程序 集 绥 存 中 找到 了 
该 程序 集 ， 那 么 解析 过 程 就 成 功 了 ， 并 且 会 加 载 找 到 的 程序 集 。 现 在 你 知道 了 ， 因 为 公 
共 语 言 运 行 时 会 首先 搜索 全 局 程序 集 缓 存 ， 因 此 全 局 程序 集 组 区 中 合适 的 程序 集 要 比 程 
序 集 文 件 有 更 高 的 优先 级 。 
口 如 果 在 全 局 程序 集 绥 存 中 没有 找到 合适 的 程序 集 , 公共 语言 运行 时 会 开始 尝试 搜索 一 系列 
文件 夹 。 可 以 使 用 app.config 文 件 中 的 codeBase 元 素来 指定 目标 文件 夹 ， 公 共 语 言 运 行 时 
会 检索 这 个 元 素 下 列 出 的 位 置 ， 如 果 还 没有 找到 合适 的 程序 集 , 那么 后 续 也 不 会 再 去 检索 
其 他 位 置 了 。 此 外 ， 黑 认 情 况 下 ， 公 共 语 言 运 行 时 还 会 去 搜索 应 用 的 安装 根 目 录 ， 通 常情 
况 下 是 程序 的 入口 文件 所 在 的 bin 目 录 。 如 果 在 安装 目录 下 也 没有 找到 合适 的 程序 集 , 解析 
过 程 就 失败 了 ， 公 共 语 言 运行 时 会 引发 一 个 异常 。 典 型 情况 下 ， 应 用 程序 会 被 终止 。 
e@ Fusion 日志 
Fusion 是 个 很 有 用 的 工具 ， 可 以 用 来 调试 公共 语言 运行 时 加 载 程 序 集 失 败 的 问题 。 比 起 尝试 
使 用 Visual Studio 调 试 器 调试 应 用 程序 ,更 好 的 办 法 是 打开 Fusion 日 志 开 关 然 后 查看 记录 到 的 日 志 
结 
要 启用 Fusion 日 志 ， 你 需要 编辑 Windows 注 册 表 。 下 面 是 具体 的 注册 表 位 置信 息 。 


HKLM\ Software\Microsoft\Fusion\ForceLog 1 
HKLM\Software\Microsoft\Fusion\LogPath C:\FusionLogs 


其 中 ForceLog 值 是 DWORD 类 型 ， 而 LogPath 是 个 字符 串 。 你 可 以 将 LogPath 设 置 为 任何 你 选 
择 的 位 置 。 代 码 清单 2-12 是 个 绑 定 程序 集 失 败 的 例子 。 


代码 清单 2-12 ”一 个 尝试 绑 定 程序 集 失 败 的 Fusion 日 志 示例 


*** Assemb1y Binder Log Entry (6/21/2013 @ 1:50:14 PM) *** 


























The operation failed. 
Bind result: hr = 0x80070002. The system cannot find the file specified. 


Assembly manager loaded from: C:\Windows\Microsoft.NET\Framework64\v4.0.30319\clr.d1l 
Running under executable C:\Program Files\1UPIndustries\Bins\v1.1.0.242\Bins.exe 
--- A detailed error log follows. 


=== Pre-bind state information === 

LOG: User = DEV\gmclean 

LOG: DisplayName = TaskbarDockUI.Xtensions.Bins.resources, Version=1.0.0.0, Culture=en-US, 
PublicKeyToken=null (Fully-specified) 

LOG: Appbase = file:///C:/Program Files/1lUPIndustries/Bins/v1.1.0.242/ 

LOG: Initial PrivatePath = NULL 

LOG: Dynamic Base = NULL 

LOG: Cache Base = NULL 

LOG: AppName = Bins.exe 

Calling assembly : TaskbarDockUI.Xtensions.Bins, Version=1.0.0.0, Culture=neutral, 





PublicKeyToken=null. 


LOG: This bind starts in default load context. 

LOG: No application configuration file found. 

LOG: Using host configuration file: 

LOG: Using machine configuration file from C:\Windows\Microsoft.NET\Framework64 
\v4.0.30319\config\machine.config. 

LOG: Policy not being applied to reference at this time (private, custom, partial, or 
location-based assembly bind). 

LOG: Attempting download of new URL file:///C:/Program Files/LUPIndustries/ 
Bins/v1.1.0.242/en-US/TaskbarDockUI .Xtensions.Bins.resources.DLL. 

LOG: Attempting download of new URL file:///C:/Program Files/lUPIndustries/ 
Bins/v1.1.0.242/en-US/TaskbarDockUI .Xtensions.Bins.resources/ 
TaskbarDockUI.Xtensions.Bins.resources.DLL. 

LOG: Attempting download of new URL file:///C:/Program Files/lUPIndustries/Bins/ 
V1.1.0.242/en-US/TaskbarDockUI.Xtensions.Bins.resources.EXE. 

LOG: Attempting download of new URL file:///C:/Program Files/1lUPIndustries/ 
Bins/v1.1.0.242/en-US/TaskbarDockUI .Xtensions.Bins.resources/ 
TaskbarDockUI.Xtensions.Bins.resources.EXE. 

LOG: All probing URLs attempted and failed. 


编辑 完 注 册 表 后 ,任何 托管 应 用 程序 的 所 有 人 解析 程序 集 的 尝试 (无 论 成 功 与 否 ) 都 会 被 记录 
到 相应 的 Fusion 日 志文 件 中 。 显 然 Fusion 下 会 有 大 量 有 用 的 日 志文 件 产生 ,但 是 在 大 量 日 志文 件 
中 查找 问题 就 像 大 海 捞 针 一样 困 难 。 

池 运 的 是 ，Fusion 还 有 个 用 户 界 面 应 用 程序 ， 可 以 帮助 开发 人 员 更 容易 找到 自己 程序 的 日 志 
文件 ， 而 不 用 直接 在 众多 的 日 志文 件 中 否 否 寻找 。 图 2-16 展 示 了 Fusion 的 用 户 界 面 。 


























Cy Assembly Binding Log Viewer SS 
Application Description Date/Time A | View Log 
VSWinExpress.exe WindowsFormslIntegration, Version=4.0.0.0, Culture=neutral, Pu... 6/4/2014 @ 10:16:18 [ Delete Entry 
VSWinExpress. exe “WindowsBase, Version=4.0.0.0, Culture=neutral, PublicKeyTok... 6/4/2014 @ 10:16:17 和 
VSWinExpress.exe “WhereRefBind!Host={LocalMachine)lFleName={NuGet.Tools.d 6/4/2014 @ 10:16:21 | DeleteANl 


VSWinExpress.exe WhereRefBind!Host={LocalMachine)!FileName={Microsoft.VSD... 6/4/2014 @ 10:16:22 er 
VSWinExpress.exe WhereRefBind!Host={LocalMachine)!FileName={Microsoft .Visu... 6/4/2014 @ 10:16:21 Es 
VSWinExpress.exe WhereRefBind!Host={LocalMachine)!FileName={Microsoft .Visu... 6/4/2014 @ 10:16:19 | Settings... 
VSWinExpress exe WhereRefBind!Host={LocalMachine)!FileName={Microsoft.Visu... 6/4/2014 @ 10:16:22 





VSWinExpress exe WhereRefBind!Host={LocalMachine)!FileName={Microsoft .Tea... 6/4/2014 @ 10:16:19 [be 一 | 
VSWinExpress.exe VSLangProj80, Version=8.0.0.0, Culture=neutral, PublicKeyTok... 6/4/2014 @ 10:16:22 Log Location 
VSWinExpress.exe VSLangProj, Version=7.0.3300.0, Culture=neutral, PublicKeyTo... 6/4/2014 @ 10:16:20 C 〇 ) Defaukt 
VSWinExpress.exe UlAutomationTypes, Version=4.0.0.0. Culture=neutral, PublicKe... 6/4/2014 @ 10:16:17 ®) Custom 
VSWinExpress exe UlAutomationProvider, Version=4.0.0.0, Culture=neutral, Public... 6/4/2014 @ 10:16:17 

VSWinExpress exe UlAutomationClient, Version=4.0.0.0, Culture=neutral, PublicKe... 6/4/2014 @ 10:16:21 Log Categories 
VSWinExpress.exe System.Xml.Ling, Version=4.0.0.0, Culture=neutral, PublicKeyT... 6/4/2014 @ 10:16:17 图 ) Defaukt 


VSWinExpress exe _ Svstem.Xml. Version=4.0.0.0. Culture=neutral. PublicKevToken 6/4/2014 @ 10:16:17 Y O Native Images 
汪 > Ea 


























图 2-16 ”Fusion 的 用 户 界面 可 以 迅速 找到 特定 程序 的 日 志文 件 


不 是 所 有 的 依赖 都 需要 直接 引用 程序 集 。 一 种 方式 就 是 将 服务 代码 部 署 为 宿主 服务 。 这 种 做 
法 需要 进程 或 网 络 间 的 数据 通讯 能 力 的 支持 , 但 是 它 能 最 小 化 客户 端 和 服务 之 间 必 和 需 的 程序 集 引 
用 。 下 一 节 会 详细 讲解 这 一 主题 。 

2. 服务 

与 程序 集 相 比 ， 客 户 端 和 服务 之 间 的 耦合 关系 更 加 松散 ， 这 种 方式 有 利 也 有 浆 。 根 据 应 用 程 
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序 需 求 的 不 同 ， 客 户 端 可 能 很 清楚 服务 的 位 置 ， 也 可 能 知之 甚 少 。 同 样 ， 实 现 服务 的 方式 不 多 ， 
因此 有 关 服 务 的 需求 也 不 多 。 选 择 不 同 的 实现 方式 ， 要 考虑 的 取舍 不 同 。 

@ 已 知 端点 

如 果 客 户 端 代 码 编译 时 就 知道 服务 位 置 , 可 以 为 客户 端 创建 一 个 服务 代理 。 至 少 有 两 种 创建 
代理 的 方式 : 使 用 Visual Studio 为 项 目 添 加 一 个 服务 引用 ， 或 者 使 用 .NET Framework 的 
Channe1Factory 类 编码 创建 服务 代理 。 

在 Visual Studio 中 为 项 目 添 加 一 个 服务 引用 非常 简单 : 只 需要 在 项 目的 快捷 菜单 上 选择 Add 
Service Reference ( 添加 服务 引用 ) 即 可 。Add Service Reference 对 话 框 只 需要 知道 Web 服 务 定 义 
语言 ( Web Service Definition Language，WSDL ) 文件 的 具体 位 置 ， 该 文件 定义 了 服务 的 元 数据 
描述 、 数 据 类 型 和 可 用 的 行为 。 选 定 服务 文件 后 ，Visual Studio 能 人 够 很 快 为 该 服务 快速 生成 一 组 
代理 类 ， 非 常 节省 时 间 。Visual Stduio 甚 至 可 以 生成 异步 的 服务 方法 以 避免 出 现 阻 蹇 。 然 而 ， 这 
种 方式 也 有 缺点 ， 开 发 人 员 对 自动 生成 的 代码 缺乏 控制 。 如 果 你 自己 的 编码 标准 要 求 比较 高 ， 
Visual Studio 生 成 的 代码 可 能 会 不 符合 要 求 。 另 外 一 个 问题 是 ， 目 动 生成 的 服务 代理 代码 只 包含 
实现 类 ， 它 不 但 没有 匹配 的 单元 测试 ， 也 没有 相应 的 接口 定义 。 

另 一 个 添加 服务 引用 的 方式 就 是 通过 编码 创建 服务 代理 。 这 种 方式 最 好 用 于 客户 端 代码 能 够 
访问 服务 接口 并 且 可 以 通过 引用 重复 使 用 时 。 代 码 清单 2-13 展 示 了 一 个 使 用 Channe1Factory 类 
编码 创建 服务 代理 的 示例 。 


代码 清单 2-13 “Channe1Factory 能 够 创建 服务 代理 


var binding = new BasicHttpBinding() ; 

var address = new EndpointAddress("http://localhost/MyService"); 

var channelFactory = new ChannelFactory<IService>(binding, address); 
var service = channelFactory.CreateChannelQO; 

service.MyOperation(); 

service.Close(); 

channelFactory.CloseQ); 




















Channe1Factory 是 个 泛 型 类 ， 它 的 构造 子 数 需要 指定 服务 代理 接口 。 男 外 ， 它 的 构造 函数 
需要 传人 Binding 和 EndpointAddress 类 的 对 象 ， 因 此 必须 给 Channe1Factory 类 提供 完整 的 地 
址 / 绑 定 /协定 (address/binding/contract，ABC ) 信息 。 在 这 个 示例 中 ，IService 接 口 就 是 具体 服 
务实 现 的 接口 。Channe1Factory 类 的 CreateChanne1] 方 法 会 返回 一 个 服务 代理 实例 ， 所 有 对 服 
务 代 理 实例 方法 的 调用 都 会 调用 服务 端 具 体 实 现 中 对 等 的 方法 。 因 为 是 使 用 同一 个 服务 接口 , 客 
户 端 类 型 可 以 通过 依赖 注入 从 构造 函数 传人 服务 接口 参数 , 这 样 客 户 端 类 型 就 可 以 立即 变 得 可 测 
斌 了。 此外， 客户 端 类 型 也 无 需 知道 它们 调用 的 是 远程 服务 。 

@ 服务 发 现 

有 时 候 , 你 可 能 只 知道 服务 的 绑 定 类 型 或 者 协定 , 但 并 不 清楚 服务 的 簿 主 地 址 。 这 种 情况 下 ， 
你 可 以 使 用 在 .NET Framework 4 中 引入 的 服务 发 现 特性 。 

服务 发 现 有 两 种 方式 : 托管 的 和 自 组 网 的 。 在 托管 模式 下 ， 有 一 个 被 称 为 发 现代 理 的 中 
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心服 务 对 所 有 客户 端 都 是 公开 的 ,客户 端 可 以 直接 请 求 这 个 中 心服 务 来 查找 其 他 可 用 的 服务 。 
这 种 模式 没有 多 大 吸引 力 ， 因 为 它 的 设计 引入 了 单一 故障 点 (single point of failure，SPOF ) 
的 反 模 式 : 如 果 发 现代 理 服 务 不 可 用 ， 所 有 客户 端 都 无 法 访问 其 他 任何 服务 ， 因 为 它们 是 不 
可 发 现 的 。 

自 组 网 模式 不 需要 发 现代 理 这 个 中 心服 务 , 它 采 用 了 组 播 网 络 消息 的 机 制 。 这 种 模式 的 默认 
实现 使 用 了 用 户 数 据 报 协 议 (User Datagram Protocol，UDP )， 每 个 可 发 现 的 服务 都 会 在 一 个 特 
定 IP 地 址 "和 端口 上 等 待 查询 请 求 。 窜 户 会 通过 发 送 组 播 消息 来 向 网 络 查询 是 否 有 符合 查询 条 件 
(协议 或 者 绑 定 类 型 ) 的 可 用 服务 。 举 个 例子 ， 在 自 组 网 模式 的 场景 中 ， 如 果 一 个 服务 不 可 用 ， 
那么 就 具有 它 是 不 可 发 现 的 ， 而 其 他 的 可 用 服务 依然 可 以 啊 应 收 到 的 查询 请 求 。 代 码 清 单 2-14 展 
示 了 如 何 编码 托管 一 个 可 发 现 的 服务 , 代码 清单 2-1$ 则 展示 了 如 何 通过 配置 来 托管 一 个 可 发 现 的 
服务 。 


代码 清单 2-14 ”编码 托管 某 个 可 发 现 的 服务 


class Program 


{ 











static void Main(string[] args) 

1 
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService))) 
1 


serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior() ) ; 


serviceHost.AddServiceEndpoint(typeof(ICalculator), new BasicHttpBinding() ， 
new Uri("http://localhost:8090/CalculatorService")); 
serviceHost.AddServiceEndpoint (new UdpDiscoveryEndpoint()); 


serviceHost.O0pen(); 
Console.WriteLine("Discoverable Calculator Service is running..."); 
Console.ReadKey (0) ; 


代码 清单 2-15 通过 配置 托管 菏 个 可 发 现 的 服务 


<system.serviceModel> 
<behaviors> 
<serviceBehaviors> 

<behavior> 
<serviceMetadata httpGetEnabled="true" httpsGetEnabled="true"/> 
<serviceDebug includeExceptionDetailInFaults="false"/> 

</behavior> 

<behavior name="calculatorServiceDiscovery"> 
<serviceDiscovery /> 


Q@ 这 个 IP 地 址 是 239.255.255.250 ( IPv4 ) 或 [FF02:C] ( Ipv6 )， 端 口 是 3702。 这 是 由 WS-Discovery 标 准 设置 的 ， 无 法 
进行 更 改 配 置 。 
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</behavior> 
</serviceBehaviors> 
<endpointBehaviors> 
<behavior name="calculatorHttpEndpointDiscovery"> 
<endpointDiscovery enabled="true" /> 
</behavior> 
</endpointBehaviors> 
</behaviors> 
<protocolMapping> 
<add binding="basicHttpsBinding”" scheme="https”" /> 
</protocolMapping> 
<serviceHostingEnvironment aspNetCompatibilityEnabled="true" 
multipleSiteBindingsEnabled="true”" /> 
<services> 
<service name="ConfigDiscoverableService.CalculatorService" 
behaviorConfiguration="calculatorServiceDiscovery"> 
<endpoint address="CalculatorService.svc" 
behaviorConfiguration="calculatorHttpEndpointDiscovery" 
contract="ServiceContract.ICalculator" binding="basicHttpBinding”" /> 
<endpoint kind="udpDiscoveryEndpoint" /> 
</service> 
</services> 
</system.serviceModel> 


要 让 服务 成 为 可 发 现 的 ， 要 做 的 就 是 为 服务 添加 ServiceDiscoveryBehavior 并 托管 一 个 
DiscoveryEndpoint。 上面 两 个 例子 中 的 UdpDiscoveryEndpoint 用 来 接收 客户 端 发 出 的 组 播 网 
络 消息 。 


注意 WEFC 提 供 的 服务 发 现 特性 是 符合 WS-Discovery 标 准 的 ， 因 此 它 也 可 以 与 .NET 
Framework 之 外 的 其 他 不 同 平 人 台 和 语言 的 协议 实现 互通 。 


客户 端 可 以 使 用 DiscoveryC1ient 类 来 查找 可 发 现 的 服务 。 首 先 需要 给 DiscoveryC1ient 
类 的 实例 传人 一 个 DiscoveryEndpoint 类 的 实例 ; 然后 创建 一 个 FindCriteria 类 的 实例 ， 该 
类 描述 了 目标 服务 的 各 种 属性 ;最 后 Find 方 法 使 用 这 个 FindCriteria 类 实例 进行 查找 并 返回 一 
个 FindResponse 类 的 实例 ， 它 的 Endpoints 属 性 包含 了 一 组 EndpointDiscoveryMetadata 实 
例 ， 其 中 的 每 个 实例 都 是 一 个 符合 查询 条 件 的 服务 。 代 码 清单 2-16 展 示 了 查找 可 发 现 服务 的 这 
些 步 又 。 


代码 清单 2-16 ”服务 发 现 是 一 种 很 好 的 代码 解 耦 方式 


class Program 


{ 














private const int a = 11894; 
private const int b = 27834; 


static void Main(string[] args) 


{ 
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var foundEndpoints = FindEndpointsByContract<ICalculator>() ; 


if (!foundEndpoints .Any()) 


{ 
Console.WriteLine("No endpoints were found."); 
} 
else 
{ 
var binding = new BasicHttpBinding(); 
var channelFactory = new ChannelFactory<ICalculator>(binding); 
foreach (var endpointAddress in foundEndpoints) 
{ 
var service = channelFactory.CreateChannel(endpointAddress); 
var additionResult = service.Add(a, b); 
Console.WriteLine("Service Found: {0}", endpointAddress.Uri); 
Console.WriteLine("{0} + {1} = {2}", a, b, additionResult); 
} 
} 


Console.ReadKey() ; 
} 


private static IEnumerable<EndpointAddress> FindEndpointsByContract 
<TServiceContract>() 
{ 
var discoveryClient = new DiscoveryClient(new UdpDiscoveryEndpoint()); 
var findResponse = discoveryClient.Find(new 
FindCriteria(typeof (TServiceContract))); 
return findResponse.Endpoints.Select(metadata => metadata.Address); 


} 





请 牢记 自 组 网 模式 使 用 的 是 UDP, 而 不 是 TCP, 因此 无 法 保证 消息 投递 的 结果 一 定 是 成 功 的 。 
可 能 出 现 的 数据 包 丢 失 情 况 , 要 么 是 因为 请 求 包 无 法 到 达 服 务 端 , 要 么 是 因为 响应 包 无 法 返回 客 
户 端 。 无 论 是 哪 种 丢 包 方式 ， 在 客户 端 看 来 束 是 处 理 请 求 的 服务 当前 不 可 用 。 








@® 提示 当 使 用 Internet 信 息 服 务 ( Internet Information Service，IIS ) 或 Windows 进 程 激活 服 
务 ( Windows Process Activation Service，WAS ) 托管 可 发 现 的 服务 时 ， 一 定 要 确保 使 用 
Microsoft AppFabric AutoStart 功 能 。 服 务 要 能 被 发 现 ， 首 先 服务 必须 是 可 用 的 ， 这 就 意味 
着 为 了 接收 客户 端的 请 求 ， 服 务必 须 首 先 处 于 运行 状态 。AppFabric AutoStart 特 性 允许 应 
用 程序 在 IIS 中 启动 时 也 能 自动 启动 服务 。 如 果 没 有 自动 启动 ， 只 有 在 第 一 次 请 求 该 服务 时 

才 会 启动 它 。 


e@ REST 化 服务 
创建 REST ( REpresentational State Transfer， 表述 性 状态 转移 ) 化 服务 的 最 大 好 处 是 客户 端 几 
乎 没有 任何 依赖 ， 只 需要 一 个 所 有 语言 的 框架 和 库 都 提供 的 HITTP client 实 例 。 因 此 REST 化 服务 
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非常 适合 开发 需要 跨 平 台 的 功能 强大 的 服务 。 举 例 来 说 ，Facebook 和 Twitter 都 为 各 种 查询 和 命令 
提供 了 丰富 的 REST API。 这 样 能 够 很 容易 为 各 种 平台 开发 客户 端 , 包括 Windows Phone 8、iPhone、 
Android、Windows 8、Linux 和 其 他 平台 。 如 果 不 使 用 REST， 单 一 的 服务 端 实 现 很 难 做 到 同时 支 
持 所 有 平台 上 的 客户 端 。 
ASPNET Web API 用 来 创建 基于 .NET Framework 的 REST 服 务 。 与 ASPNET MVC 框 架 类 似 ， 

它 也 允许 开发 人 员 创 建 能 直接 映射 为 网 络 请 求 的 方法 。ASPNET Web API 提 供 了 一 个 名 为 
ApiController 的 基础 控制 器 类 , 通过 继承 这 个 类 并 实现 一 些 使 用 HTTP 动 作 (GET、POST、PUT、 
DELETE. HEAD、0OPTIONS 和 PATCH 等 ) 作为 名 称 的 方法 后 ， 当 接收 到 一 个 带 有 某 个 动作 名 称 的 
HTTP 请 求 时 ， 相 应 名 称 的 方法 就 会 被 执行 。 代 码 清单 2-17 展 示 了 一 个 实现 了 所 有 HTTP 动 作 命名 
方法 的 服务 。 


代码 清单 2-17 ASPNET Web API 几 乎 支持 所 有 HTTP 动 作 


public class ValuesController : ApiController 


{ 











public IEnumerable<string> Get() 
{ 


return new string[] { "valuel", "value2" }; 


} 


public string Get(int id) 
{ 


return "value"; 


} 


public void Post([FromBody]string value) 
{ 
} 


public void Put(int id, [FromBody]string value) 
{ 
} 


public void Head () 
{ 
} 


public void Options() 


public void Patch() 


public void Delete(int id) 
{ 
} 
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代码 清单 2-18 ”客户 端 可 以 使 用 HttpC1ient 类 访问 任何 REST 化 服务 


class Program 


{ 
static void Main(string[] args) 
{ 
string uri = "http://localhost:7617/api/values"; 
MakeGetRequest (uri); 
MakePostRequest(uyuri); 
Console.ReadKey() ; 
} 
private static async void MakeGetRequest(string uri) 
{ 
var restClient = new HttpClient() ; 
var getRequest = await restClient.GetStringAsync(uri); 
Console.WriteLine(getRequest); 
} 
private static async void MakePostRequest(string uri) 
{ 
var restClient = new HttpClient() ; 
var postRequest = await restClient.PostAsync(uri, 
new StringContent("Data to send to the server")); 
var responseContent = await postRequest.Content.ReadAsStringAsyncOQO; 
Console.WriteLine(responseContent); 
} 
} 





为 了 强调 所 有 平台 上 的 客户 端 都 几乎 一 样 没 有 依赖 ， 代 码 清 单 2-19 展 示 了 一 个 使 用 Windows 
PowerShell 3 脚本 编码 访问 服务 GCT 和 POST 方法 的 示例 。 


代码 清单 2-19 ”使 用 Windows PowerShell 3 访问 REST 化 服务 一 样 非常 简单 


$request = [System.Net.WebRequest]::Create("http://1localhost:7617/api/values") 
$request.Method ="GET" 
$request.ContentLength = 0 


$response = $request.CetResponse() 

$reader = new-object System.I1I0.StreamReader($response.CGetResponseStream()) 
$responseContent = $reader.ReadToEnd() 

Write-Host $responseContent 





在 上 面 的 示例 中 ， 脚 本 代码 使 用 ,NET Framework 的 WebRequest 类 的 对 象 来 访问 REST 化 服 
务 。 其 中 ，WebRequest 类 是 HttpRequest 的 父 类 ， 它 的 Create 方 法 是 个 工厂 方法 ,会 根据 传人 
的 http:/ 开 头 的 URI 字 符 串 返回 一 个 HttpRequest 类 的 实例 。 
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2.2.7 ”使 用 NuGet 管理 依赖 


依赖 管理 工具 能 够 大 大 人 简化 依赖 管理 工作 。 它们 会 负责 跟踪 依赖 链 并 准备 好 所 有 要 依赖 的 程 
序 集 和 相关 资料 ， 同 时 还 会 负责 管理 依赖 版 本 。 开 发 人 员 只 需要 指定 依赖 的 具体 版 本 ， 剩 下 的 工 
作 会 由 管理 工具 自动 完成 。 

NuGet 是 一 个 .NET Framework 的 包 管理 工具 。 这 里 ，NuGet 将 依赖 称 为 包 ， 其 中 不 仅 可 以 包 
括 程序 集 ， 还 可 以 包括 配置 、 脚 本 以 及 图 像 等 任何 你 需要 的 数据 。 使 用 诸如 NuGet 之 类 的 包 管 理 
器 的 最 有 说 服 力 的 理由 之 一 就 是 , 这 些 工具 对 包 的 依赖 关系 非常 了 解 。 它 们 能 为 需要 引用 包 的 项 
目 自动 导入 整个 依赖 链 上 所 有 需要 的 文件 和 数据 。 

从 Visual Studio 2013 开 始 ，NuGet 已 经 作为 默认 的 包 管理 工具 被 完全 集成 到 Visual Studio IDE 
当中 了 。 

1. 使 用 包 

NuGet 为 Visual Studio 解 决 方案 浏览 窗口 增添 了 一 些 新 的 快捷 菜单 项 。 选择 任 一 菜单 ,你 就 可 
以 打开 NuGet 包 管理 窗口 并 添加 对 依赖 的 引用 。 

举 个 例子 , 我 打算 引用 Corrugatedlron , 它 是 一 个 用 于 存储 Riak 非 Sql 键 值 对 的 .NET Framework 
客户 驱动 程序 。 图 2-17 是 NuGet 包 管理 窗口 的 截图 。 
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图 2-17 NuGet 包 带 有 很 多 有 用 的 元 数据 


在 NuGet 包 管理 窗口 的 列表 中 选择 了 一 个 包 时 ， 右 侧 的 信息 面板 就 会 显示 出 这 个 包 的 一 些 元 
数据 ， 其 中 包括 : 独一无二 的 命名 、 作 者 、 版 本 、 最 后 修改 日 期 、 描 述 以 及 自身 的 所 有 依赖 。 在 
引用 一 个 包 前 ， 首 先 要 根据 版 本 要 求 安 装 并 引用 这 个 包 上 自身 的 所 有 依赖 。 以 Corrugatedlron 为 例 ， 
它 需 要 一 个 版 本 不 低 于 4.5.10 的 Newtonsoft.Json 包 、 一 个 .NET Framework JSON/ 类 序列 化 器 和 一 个 
版 本 不 低 于 2.0.0.602 的 protobuf-net 包 。 而 这 些 被 Corrugatedlron 依 赖 的 包 自 身 也 都 有 一 些 依赖 。 
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当 你 选择 安装 包 后 ，NuGet 首 先 会 尝试 下 载 所 有 相关 文件 并 把 它们 存放 在 解决 方案 的 
packages/ 文 件 夹 下 。 这 样 做 的 好 处 是 ， 与 本 章 开始 介绍 的 手动 创建 dependencies/ 文 件 夹 一 样 ， 也 
可 以 对 整个 文件 夹 进行 源 代码 管理 。 当 你 需要 使 用 这 些 库 时 ，NuGet 会 自动 将 下 载 好 的 程序 集 加 
入 到 引用 列表 中 。 图 2-18 展 示 了 添加 Riak 包 后 的 项 目 引 用 列表 。 


4 大 References 


a Corrugatedlron 
mm Microsoft.CSharp 
Newtonsoft.Json 


mm protobuf-net 


a System 


nSystem.configuration 


nm System.Core 


ma System,.Data 


mSystem.Data.DataSetExtensions 
"System.Numerics 


nSystem.Xml 


ma System.Xml.Ling 


昌 App.config 


图 2-18 NuGet 工 具 会 将 目标 包 及 其 所 有 依赖 一 起 自动 加 入 到 了 项 目的 引用 列表 中 


除了 添加 对 包 的 引用 外 ，NuGet 工 具 还 会 创建 一 个 包含 项 目 所 引用 包 及 其 版 本 信息 的 
packages.config 文 件 。 这 些 信 息 会 在 NuGet 工 具 升 级 和 钊 载 包 时 用 到 。 


在 真正 使 用 Riak 的 功能 前 ， 








还 需要 进行 一 些 默 认 的 配置 。 所 以 NuGet 不 只 是 为 项 目下 载 和 引 





用 了 很 多 程序 集 , 它 还 上 自动 根据 Riak 功 能 的 需要 在 项 目的 app.config 文 件 中 设置 了 一 些 默认 值 。 代 
码 清单 2-20 展 示 了 安装 Riak 之 后 的 app.config 文 件 内 容 。 


代码 清单 2-20 NuGet 工 具 在 app.config 文 件 中 专门 为 Riak 添 加 了 一 个 新 的 configSection 


<Configuration> 
<configSections> 


<section name="riakConfig" type="CorrugatedIron.Config.RiakClusterConfiguration, 


CorrugatedIron” /> 
</configSections> 


<riakConfig nodePollTime="5000" defaultRetryWaitTime="200" defaultRetryCount="3"> 


<nodes> 
<node name="dev1" hostAddress="riak-test" 
restPort="10018" poolSize="20" /> 
<node name="dev2" hostAddress="riak-test" 
restPort="10028" poolSize="20" /> 
<node name="dev3" hostAddress="riak-test" 
restPort="10038" poolSize="20" /> 
<node name="dev4" hostAddress="riak-test" 
restPort="10048" poolSize="20" /> 
</nodes> 
</riakConfig> 
</configuration> 


pbcPort= 
pbcPort= 
pbcPort= 


pbcPort= 


"10017" 


"10027" 


"10037" 


"10047" 


restScheme= 


restScheme= 


restScheme= 


restScheme= 


"http" 
"http" 
"http" 


"http" 


很 显然 ,使 用 NuGet 工具 能 为 你 市 省 大 量 的 时 间 。 你 无 需 花 费 精 力 在 Riak 的 官网 上 下 载 





Corrugatedlron 及 其 所 有 依赖 程序 集 。 这 有 助 于 你 专注 于 真正 的 开发 工作 上 。 当 需要 将 Corruga- 
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tedlron 升 级 到 新 版 本 时 ， 你 只 需要 使 用 NuGet 工 具 自 动 为 整个 解决 方案 更 新 所 有 相关 的 包 即 可 。 

2. 制作 包 

NuGet 工 具 还 提供 了 创建 新 包 的 功能 。 你 可 以 自己 创建 包 并 将 其 发 布 到 NuGet 的 官方 商店 ， 
这 样 其 他 开发 人 员 就 可 以 使 用 你 的 自制 包 , 或 者 你 想 把 所 有 第 一 方 依赖 制作 成 包 以 便 在 项 目 内 部 
同步 引用 。 图 2-19 展 示 了 使 用 NuGet 包 浏览 带 创 建 自制 包 的 和 截图。 在 我 的 这 个 自制 包 里 ， 我 把 
CorrugatedIron 设 置 为 依赖 项 ， 因 此 它 也 会 隐 式 依赖 Newtonsoft.Json 和 Protobuf-net 这 两 个 包 。 我 还 
为 这 个 包 添 加 了 一 个 专门 针对 .NET Framework4.5.1 的 库 工 件 ， 还 添加 了 一 个 将 在 My folder/ 
NewFile.txt 下 引用 的 程序 集中 创建 的 文本 文件 。 包 含 NewFile.txt 的 文件 夹 MyFolder， 它 们 会 被 复 
制 到 包 的 安装 目录 下 。 此 外 ， 还 有 一 个 Windows PowerShell 脚 本 ， 它 会 在 包 的 安装 过 程 中 执行 。 
可 以 在 这 个 脚本 中 完成 很 多 自 定 义 动作 ， 在 此 需要 感谢 一 下 强大 的 Windows PowerShell。 

















el NuGet Package Explorer - MyTestPackage.1.0.0 
‘EllE EDIT VEW CONTENT IOOLS HELP 


-5 





Package metadata Package contents 


加 你 


ld: MyTestPackage 
Version: 1.0.0 


4 哄 且 


4 国 net451 (.NETFramewor 


MyAssembly.dil 
4 Da My Folder 


k,Version=v4.5.1) 


Authors: Gary McLean Hall 
Description: 


NewFile.bd 
4 销 tools 
岛 install.ps1 


My package description. 














图 2-19 ”使 用 NuGet 包 浏览 姨 可 以 轻松 创建 自己 的 包 


NuGet 生 成 的 每 个 包 都 会 有 一 个 XML 文件 ， 其 中 包含 了 要 在 安装 窗口 中 显示 的 详细 元 数据 。 
代码 清单 2-21 展 示 了 XML 文件 内 容 的 一 个 示例 。 


代码 清单 2-21 包含 了 包 的 详细 元 数据 的 XML 定义 


<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd"> 
<metadata> 
<id>MyTestPackage</id> 
<version>1.0.0</version> 
<authors>Gary McLean Hall</authors> 
<requireLicenseAcceptance>false</requirelicenseAcceptance> 
<description>My package description.</description> 
<dependencies> 
<dependency id="CorrugatedIron" version="1.0.1" /> 
</dependencies> 
</metadata> 
</package> 











对 于 一 直 痛 将 地 手动 打 理 大 量 第 三 方 依赖 的 人 来 说 ，NuGet 这 个 高 效 的 工具 真 可 谓 是 个 天 大 


CR 


的 福利 。 而 实际 上 , NuGet 也 并 不 局 限于 管理 第 三 方 依赖 。 当 一 个 解决 方案 的 规模 变 得 足够 大 时 ， 
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最 好 是 能 通过 分 层 将 整个 解决 方案 划分 为 多 个 部 分 。 可 以 把 每 一 层 的 所 有 程序 集 放 入 一 个 NuGet 
包 以 供 上 层 使 用 。 这 样 划 分 后 得 到 的 多 个 小 规模 的 解决 方案 很 容易 进行 协调 管理 。 

3. 工具 Chocolatey 

与 NuGet 工 具 类 似 ，Chocolatey 也 是 一 种 包 管 理工 具 。 不 同 的 地 方 是 ，NuGet 的 包 是 一 些 程序 
集 ， 而 Chocolatey 的 包 是 一 些 应 用 程序 和 工具 。 了 解 Linux 的 开发 人 员 会 发 现 Chocolatey 有 点 像 
Debian 和 Ubuntu 系 统 上 的 包 管 理 紫 apt-get。 青 哎 呆 一 帝 ， 包 管理 工具 的 好 处 有 : 简易 安装 、 依 
赖 管理 以 及 轻松 使 用 。 

下 面 的 Windows PowerShell 肢 本 用 来 下 载 和 安装 Chocolatey。 


Qpowershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object 
net.webclient) .DownloadString('https://chocolatey.org/install.ps1'))" && SET 
PATH=%PATH%;%systemdrive%\chocolatey\bin 


安装 好 Chocolatey 后 , 你 可 以 使 用 命令 行 搜索 和 安装 各 种 应 用 和 工具 。Chocolatey 的 安装 程序 
已 经 更 新 了 命令 行路 径 ， 以 包含 Chocolatey.exe 应 用 。Chocolatey 和 Git 一 样 也 有 一 些 诸如 11st 和 
instal1 之 类 的 子 命令 ,不 同 的 是 ， 它 还 分 别 为 这 些 子 命令 提供 了 诸如 cl1ist 和 cinst 之 类 的 快 
捷 方式 。 代 码 清 单 2-22 展 示 了 一 个 Chocolatey 会 话 示 例 ， 用 来 搜索 和 安装 名 为 FileZilla (一 个 FTP 
客户 端 应 用 程序 ) 的 包 。 


代码 清单 2-22 ”查找 并 安装 需要 的 应 用 程序 包 


C:\dev> clist filezilla 

ferventcoder .chocolatey.utilities 1.0.20130622 

filezilla 3.7.1 

filezilla.commandline 3.7.1 

filezilla.server 0.9.41.20120523 

jivkok.tools 1.1.0.2 

kareemsultan.developer .toolkit 1.4 

UAdevelopers.utils 1.9 

C:\dev> cinst filezilla 

Chocolatey (v0.9.8.20) is installing filezilla and dependencies. By installing you accept the 
license for filezilla and each dependency you are installing. 














This Finished installing 'filezilla' and dependencies - if errors not shown in console, none 
detected. Check log for errors if unsure. 





只 要 Chocolatey 没 有 报错 ,请 求 的 包 就 已 经 成 功 安 装 了 。 有 一 点 要 警惕 的 是 ，Chocolatey 为 了 
从 命令 行 执行 新 安装 应 用 程序 或 工具 的 二 进 制 文件 ， 可 能 会 修改 系统 PATH 环境 变量 。Chocolatey 
工具 能 够 搜索 到 大 量 的 应 用 程序 和 工具 包 ， 这 就 是 它 的 强大 优势 。 














2.9 -个 层 


至 此 , 本章 前 面 都 是 在 讲解 程序 集 层 次 的 依赖 管理 。 当 然 , 管理 好 程序 集 层次 的 依赖 很 卓然 
是 组 织 应 用 程序 的 第 一 步 , 因为 所 有 类 和 接口 部 包含 在 程序 集中 ,而 且 这 些 程 序 集 之 间 如 何 关 联 
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也 是 开发 人 员 普 过 担心 的 问题 。 组 织 好 程序 集 层次 的 依赖 关系 后 , 所 有 程序 集会 包含 附属 于 一 组 
相关 功能 的 类 和 接口 。 然 而 ， 你 又 如 何 保证 程序 集 的 组 划分 是 正确 的 呢 ? 

在 开发 的 软件 系统 中 , 几 个 相关 的 程序 集会 形成 一 个 组 件 。 以 相似 且 定 义 良 好 的 结构 化 方式 
管理 组 件 间 的 互动 和 管理 程序 集 层 次 上 的 依赖 关系 一 样 重要 ( 甚至 更 重要 )。 如 图 2-20 所 示 ,， 一 
个 组 件 通 篆 不 是 要 最 终 部 署 的 DLL 或 EXE 文 件 ， 而 是 一 个 逻辑 程序 集 组 , 组 中 的 这 些 程序 集 在 功 
能 上 是 相关 的 。 











一 
AccountController| | CatalogController ProductData 





图 2-20 可 以 通过 将 功能 相关 的 程序 集 划 分 到 同一 个 组 来 定义 逻辑 组 件 


图 中 包括 了 三 个 程序 集 : 视图 、 控 制 颖 和 视图 模型 。 每 个 程序 集 包 含 了 两 个 类 型 ， 它 们 的 功 
能 不 同 , 需要 的 依赖 也 可 能 不 同 , 图 2-20 中 用 户 界 面包 所 包含 的 类 型 和 程序 集 都 是 逻辑 上 的 概念 ， 
而 不 是 实际 的 .NET Framework 类 和 程序 集 实体 。 你 可 以 把 这 三 个 程序 集 放置 在 解决 方案 下 的 一 个 
名 为 UserInterfaces 的 文件 夹 下 ,也 可 以 再 将 一 个 与 用 户 界面 没有 任何 关系 的 程序 集 加 入 进来 ， 当 
然 , 这 会 让 用 户 界面 这 个 分 组 变 得 名 不 副 实 。 你 自己 要 多 多 留意 ， 因 为 没有 其 他 办 法 能 防止 出 现 
这 种 情况 。 

在 依赖 管理 的 上 下 文中 , 组 件 和 其 他 更 低层 次 的 编码 概念 没有 差别 。 与 方法 、 类 以 及 程序 集 
一 样 ， 层 次 (layer ) 也 可 以 作为 本 间 前 面 所 讲 的 依赖 图 中 的 节点 。 因 此 ， 对 层次 市 点 也 可 以 应 用 
相同 的 规则 :确保 有 癌 图 无 环 且 提 供 单一 职员 。 

分 层 ( layering ) 是 一 种 架构 模式 ， 它 发 励 开 发 人 员 将 软件 组 件 看 作 是 水 平 功能 层 ， 而 一 个 完 
整 的 应 用 程序 可 以 划分 为 多 个 水 平 功能 层 。 分 层 形成 的 组 件 一 个 羞 加 在 另外 一 个 上 面 , 它们 的 依赖 
关系 方向 必须 朝 下 。 也 就 是 说 ， 程 序 最 底层 的 组 件 没 有 依赖 "， 每 个 层 只 能 依赖 它 的 直接 下 层 。 通 
第 情况 下 ， 应 用 程序 的 项 层 都 是 用 户 界面 ， 服 务 程序 的 项 层 都 是 客户 端 用 来 与 服务 端 交 互 的 API。 




















2.3.1 常见 的 模式 

任何 项 目 都 可 以 从 常见 的 几 个 分 层 模式 中 找到 适合 自身 的 模式 。 本 节 要 介绍 的 几 个 分 层 模 式 
只 是 仅 供 参考 , 你 还 需要 对 它们 进行 定制 以 符合 实际 项 目的 具体 需求 和 限制 。 这 几 种 分 层 模 式 之 
间 唯 一 的 区 别 就 是 分 层 数 目 不 同 。 本 节 会 先 介 绍 最 简单 的 两 层 划 分 模式 , 然后 讲解 加 入 中 间 层 的 

















J 严格 来 讲 ， 还 可 能 有 对 第 三 方 的 基础 构件 程序 集 的 依赖 , “没有 依赖 ”在 这 里 只 是 为 了 表示 最 低层 不 再 依赖 任何 
第 一 方 的 代码 。 
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三 层 划分 模式 ， 最 后 引入 任意 分 层 模式 的 介绍 。 

需要 的 分 层 数目 与 方案 的 复杂 度 相 关 ， 而 方案 的 复杂 度 又 与 问题 的 复杂 度 相 关 。 因 此 ， 问 题 
越 复杂 ， 越 可 能 引入 更 多 分 层 的 架构 。 在 这 种 情况 下 ,复杂 度 由 很 多 因素 决定 ， 其 中 包括 : 项 目 
的 时 间 限 制 、 需 要 的 持久 度 、 需 求 的 变更 频率 以 及 开发 团队 对 模式 及 其 实践 的 重视 程度 等 。 

因为 本 书 旨 在 讲解 如 何 适 应 需求 变更 , 因此 , 我 主张 尽量 从 最 简单 的 方案 开始 ,后 面 有 需要 
时 才 将 它 重 构 为 更 复杂 的 方案 。 这 种 方式 对 项 目 开 发 有 很 多 好 处 。 能 尽快 交付 一 些 成 果 给 客户 并 
且 能 够 尽早 获得 大 量 的 重要 反馈 。 总 是 妃 求 很 完美 的 方案 是 没有 意义 的 , 因为 客户 心中 的 完美 与 
开发 团队 想象 的 完美 有 可 能 不 一 样 。 多 层 架 构 要 比 简单 的 两 层 划分 方案 耗费 更 多 的 开发 时 间 , 也 
无 法 及 时 获取 重要 的 用 户 反 馈 。 



































逻辑 层 与 物理 层 

逻辑 层 和 物理 层 之 间 的 区 别 就 是 代码 逻辑 组 织 和 物理 部 署 的 区 别 。 逻辑 上 ,你 可 以 把 应 
用 程序 的 代码 拆 分 为 多 个 逻辑 层 (layer )， 但 是 物理 上 ， 你 依然 可 以 把 它们 部 署 在 同一 个 物 
理 层 (tier) 上 。 物 理 层 的 数目 就 是 单个 应 用 程序 拆 分 部 署 的 宿主 机 器 数目 。 如 果 整 个 应 用 
程序 被 部 署 在 同一 台 机 器 上 ， 也 就 是 说 应 用 被 部 署 在 单个 物理 层 上 了 。 如 果 应 用 程序 (至少 
有 两 个 逻辑 层 ) 被 拆 分 部 署 在 两 台独 立 的 机 器 上 ， 也 就 是 说 应 用 被 部 署 在 两 个 物理 层 上 了 。 

采用 多 物理 层 的 部 署 方式 ,就 意味 着 不 同 物理 层 上 同一 应 用 程序 的 不 同 罗 辑 层 间 的 交互 
会 跨越 网 络 边界 ,这 自然 也 会 产生 时 间 性 能 上 的 相应 代价 。 同 一 台 机 器 上 的 跨 进程 交互 的 时 
间 代价 已 经 比较 高 了 ， 而 跨越 网 络 边界 交互 的 时 间 代 价 比 前 者 还 要 高 出 很 多 。 尽 管 如 此 ， 多 
物理 层 的 部 署 方式 依然 有 一 个 明显 的 优势 ， 那 就 是 它 赋 耶 应 用 程序 更 好 的 扩展 能 力 。 假设 有 
一 个 三 层 ( 包 括 用 户 界面 层 、 逻 辑 层 和 数据 访问 层 ) 划分 架构 的 网 络 应 用 程序 ， 它 被 部 署 在 
单 台 机 器 上 (也 就 是 单个 物理 层 上 )， 那 么 这 人 台 机 器 能 够 支持 的 用 户 数目 一 定 不 高 ， 因 为 它 
本 身 需要 完成 所 有 三 个 逻辑 层 的 众多 任务 。 如 果 将 应 用 程序 拆 分 部 署 在 两 个 物理 层 上 ( 把 用 
户 界面 和 逻辑 层 部 署 在 一 台 机 器 上 ， 而 把 数据 访问 层 部 署 在 另外 一 台独 立 的 机 器 上 )， 你 不 
仅 可 以 横向 扩展 用 户 接口 还 辑 层 ， 还 可 以 纵向 扩展 它 。 

为 了 纵向 扩展 ， 你 只 需要 通过 添加 内 存 和 处 理 单元 等 方式 增加 机 器 的 能 力 ， 因 为 机 器 的 
能 力 增强 了 ， 本身 就 能 完成 更 多 的 任务 了 。 此 外 ,你 也 可 以 通过 增加 执行 相同 任务 的 新 的 独 
立 机 器 来 实现 模 向 扩展 。 这 样 ,会 有 多 台 机 器 托管 同样 的 网 页 用 户 界面 代码 ， 负 载 均 衡器 会 
实时 将 客户 端的 请 求 分 配给 最 空闲 的 机 器 处 理 。 当 然 ， 这 种 部 署 方式 并 不 能 解决 网 络 应 用 场 
景 中 的 多 用 户 并 发 访问 的 问题 。 因 为 同一 用 户 的 多 个 不 同 请 求 可 能 由 不 同 的 机 器 来 处 理 ， 这 
需要 你 谨慎 处 理 好 数据 缓存 和 用 户 身份 验证 。? 


1. 两 层 划 分 
对 没有 明确 分 层 方案 的 最 简单 改进 就 是 两 层 划 分 的 方案 。 尽 管 两 层 方 案 的 应 用 场景 也 不 多 ， 


中 后面 当 逻 辑 层 和 物理 层 同 时 出 现时 才 会 使 用 全 称 ， 否 则 layer 和 tier 都 会 简称 为 层 。 一 一 译 者 注 
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但 是 实现 它 所 需 的 时 间 非 常 短 。 这 两 个 层次 分 别 是 用 户 界面 层 和 数据 访问 层 。 但 是 请 记 住 ,只 有 
两 个 层次 并 不 是 只 有 两 个 程序 集 , 而 是 有 两 组 泌 辑 相关 的 程序 集 : 一 组 与 用 户 界面 直接 相关 ， 另 
外 一 组 与 数据 访问 相关 。 

图 2-21 的 UML 图 展示 了 两 个 层次 的 依赖 关系 , 每 个 层次 都 包含 了 一 组 逻辑 相关 的 程序 集 。 无 
论 分 层 数目 的 多 少 ， 每 个 层次 都 必须 目 只 能 依赖 直接 下 层 。 








图 2-21 一 个 两 层 划 分 的 应 用 由 界面 组 件 和 数据 访问 组 件 组 成 





@ 用 户 界 面 层 

用 户 界 面 层 的 职责 包括 以 下 四 项 。 

口 为 用 户 提 供与 应 用 程序 交互 的 方式 (比如 : 桌面 窗口 和 控件 、 网 页 或 者 带 有 命令 行 或 菜 

单 的 控制 台 应 用 程序 )。 

口 向 用 户 展示 数据 和 信息 。 

口 接收 用 户 的 查询 或 命令 请 求 。 

口 验证 用 户 的 输入 。 

用 户 界面 层 有 很 多 种 不 同 的 实现 方式 。 它 可 以 是 一 个 带 有 绚丽 图 像 和 动画 的 WPF 客 户 端 , 也 
可 以 是 一 组 导航 网 页 ,抑或 是 一 个 带 有 命令 行 开 关 参 数 或 简单 菜单 (供用 户 选 择 以 及 执行 查询 或 
命令 ) 的 控制 台 应 用 程序 。 











注意 有些 情况 下 ， 用 户 界 面 会 被 一 组 为 客户 端 提 供 功 能 的 服务 代 蔡 。 这 组 服务 并 不 是 真 
正 可 视 的 用 户 界面 , 但 是 两 层 划 分 的 架构 依然 很 清晰 ,只 是 用 服务 API 层 代替 了 用 户 界面 层 。 


用 户 界 面 层 可 以 使 用 数据 访问 层 的 功能 , 然而 ,正如 本 章 前 面 所 讲 的 ， 用 户 界面 层 不 应 该 直 
接 引 用 数据 访问 层 具体 实现 所 在 的 程序 集 。 这 两 个 层次 的 接口 和 实现 程序 集 也 应 该 是 严格 分 开 
的 。 图 2-21 的 分 层 经 过 改进 后 看 起 来 如 图 2-22 所 示 。 

实际 上 , 这 就 是 在 通过 阶梯 模式 解决 随从 反 模 式 市 来 的 缺陷 ,只 是 这 里 的 缺陷 是 架构 级 别 上 
的 问题 。 每 个 层次 都 是 由 上 层 所 需 功能 的 抽象 以 及 该 抽象 的 实现 组 合 而 成 。 如 果 一 个 层次 开始 引 
用 直接 下 层 的 部 分 实现 ， 那 么 这 个 下 层 被 称 为 抽象 漏洞 〈1leaky abstraction )。 因 为 对 该 层 实现 的 
依赖 会 逐渐 看 延 到 更 高 的 上 层 中 ， 从 而 引入 了 本 来 可 以 避免 的 依赖 关系 。 
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数据 访问 接口 
数据 访问 实现 


图 2-22 ”两 个 层次 会 各 自分 割 为 各 自 相 关 的 实现 程序 集 和 接口 程序 集 












@ 数据 访问 层 

数据 访问 层 的 职责 包括 以 下 两 项 。 

口 啊 应 数据 查询 请 求 。 

口 序列 化 对 象 模型 到 关系 模型 ， 反 序列 化 关系 模型 到 对 象 模 型 。 

与 用 户 界 面 层 一 样 , 数据 访问 层 的 实现 也 可 以 有 很 多 种 。 这 一 层 通常 会 包含 某 种 持久 数据 存 
储 器 ， 它 可 能 是 诸如 SQL Server、Oracle 、MYySQL 或 PostegreSQL 等 关系 型 数据 库 ， 也 可 以 是 诸如 
MongoDB、RavenDB 或 Riak 等 文档 型 数据 库 。 除了 数据 存储 机 制 之 外 ,还 可 能 存在 一 个 或 多 个 辅 
助 程序 集 。 这 些 辅助 程序 集 要 么 通过 调用 存储 过 程 来 执行 查询 或 插入 /更 新 /删除 命令 ， 要 么 通过 
Entity Framework 或 NHibernate 将 数据 映射 到 关系 型 数据 库 。 

数据 访问 层 的 所 有 接口 都 应 该 隐藏 所 有 与 技术 相关 的 事情 , 也 不 应 该 引入 任何 对 第 三 方 的 依 
赖 ， 这 样 才 可 以 保证 客户 端 完 全 不 受 具 体 实 现 选 择 的 影响 。 

设计 良好 的 数据 应 用 层 能 够 在 多 个 应 用 程序 中 重用 。 如 果 两 个 用 户 界 面 需 要 把 相同 的 数据 展 
示 为 不 同 的 表格 形式 时 ， 它 们 就 可 以 共享 同一 个 数据 访问 层 。 假 设 一 个 应 用 程序 需要 同时 支持 
Windows 8 和 Windows Phone 8， 虽 然 两 个 平台 上 的 用 户 界 面 需求 不 同 ， 但 是 都 可 以 使 用 同样 的 数 
据 访问 层 。 

与 其 他 架构 方式 一 样 , 在 实际 采用 两 层 划 分 之 前 需要 清楚 该 方案 的 优 缺点 。 以 下 是 适合 采用 
两 层 划 分 架构 的 一 些 场 景 。 

口 应 用 程序 只 有 一 些 琐碎 的 数据 验证 上 且 没有 多 少 业 务 逻 辑 ， 可 以 将 它们 直接 归 到 数据 访问 

层 或 用 户 界 面 层 中 。 

口 应 用 程序 主要 执行 数据 的 创建 、 读 取 、 更 新 和 删除 ( creating, reading, updating, and deleting， 
CRUD ) 操作 。 在 用 户 界 面 和 数据 访问 层 间 增加 额外 层 会 导致 CRUD 变 得 更 加 困难 。 

口 如 果 只 是 需要 开发 一 个 原型 或 模拟 程序 ， 限 制 分 层 数目 会 节省 很 多 开发 时 
间 ， 也 能 让 概念 验证 的 可 行 性 更 加 明确 。 如 果 你 能 坚持 用 好 诸如 阶梯 模式 等 好 的 开发 实 
践 ， 和 赤 需 要 额外 的 层次 时 再 添加 也 会 更 容易 。 

但 是 ， 两 层 架 构 也 有 明显 的 缺陷 ， 它 不 适合 在 以 下 场景 中 应 用 。 

口 应 用 程序 预期 或 已 确定 会 有 复杂 的 业务 加 辑 。 从 技术 角度 讲 ， 将 业务 逻辑 放 和 人 用户 界 面 
层 或 数据 访问 层 会 破坏 这 两 层 的 设计 初衷 ， 导 致 它们 变 得 不 够 灵活 且 难 以 维护 。 

口 应 用 程序 已 明确 在 一 两 个 冲刺 后 会 需要 多 于 两 层 的 架构 。 如 果 一 个 临时 架构 只 维持 短 短 
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的 几 周 时 间 ， 那 么 为 了 能 尽快 得 到 反馈 而 快速 实现 这 个 临时 方案 其 实 是 不 值得 的 。 
两 层 架 构 依 然 是 一 个 很 实用 的 选择 , 但 很 多 开发 人 员 都 会 着 迷 于 最 新 的 架构 趋势 而 名 视 这 些 
简洁 的 设计 ,他们 会 把 一 个 简单 的 应 用 复杂 化 ,不仅 错 失 及 时 的 用 户 反 馈 ， 而 且 难 以 维护 。 通 常 





情况 下 ， 最 简单 的 方案 可 能 就 是 正确 的 方案 。 2 
2. 三 层 划 分 








三 层 划分 的 架构 是 在 用 户 界 面 层 和 数据 访问 层 之 间 增 加 了 一 个 业务 逻辑 层 。 应 用 会 在 增加 的 
业务 逻辑 层 中 封装 更 复杂 的 处 理 逻 辑 。 与 数据 访问 层 一 样 ， 同 一 份 业 务 逻 辑 层 也 可 以 由 不 同 的 用 
户 界 面 层 重 用 。 图 2-23 是 一 种 典型 的 三 层 架 构 。 





图 2-23 ”中 间 层 包含 了 应 用 的 处 理 或 业务 逻辑 
再 强调 一 次 , 业务 逻辑 层 和 数据 访问 层 一 样 ， 需 要 为 客户 端 提 供 接口 和 实现 两 个 程序 集 ， 要 
避免 成 为 抽象 漏洞 。 


[ 慎 ] 注意 尽管 网 络 应 用 大 多 数 都 采用 三 个 逻辑 层 的 架构 方式 ， 但 是 通常 是 部 署 在 两 个 物理 层 
上 的 。 一 个 物理 层 专 门 负责 数据 库 ， 另 外 一 个 物理 层 负 责 其 余 事 情 : 用 户 界面 、 业 务 逻 辑 其 
至 部 分 数据 访问 工作 。 


@ 业务 逻辑 层 

业务 逻辑 层 的 职责 包括 以 下 两 项 。 

口 处 理 来 自用 户 界 面 层 的 命令 。 

口 为 业务 域 的 流程 、 规 则 和 工作 流 建 模 。 

业务 逻辑 层 有 可 能 是 一 个 命令 处 理 右 , 它 会 在 接收 用 户 通过 用 户 界 面 层 下 达 的 命令 后 , 协同 
数据 访问 层 一 起 解决 某 个 具体 问题 或 执行 某 项 特别 任务 。 业 务 逻 辑 层 也 可 以 是 一 个 业务 域 模型 ， 
它 把 整个 业务 的 所 有 过 程 映 射 在 软件 设计 和 实现 当中 。 对 于 后 者 , 通常 会 在 数据 访问 层 中 增加 一 
个 对 象 /关系 映射 ( Object/Relational Mapping ，ORM ) 组 件 ， 这 样 可 以 通过 域 驱 动 设计 
( domain-driven design，DDD ) 的 方式 直接 实现 逻辑 层 的 类 型 。 域 模型 应 该 没有 任何 依赖 ， 既 不 
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依赖 任何 下 层 ， 也 不 依赖 具体 的 实现 技术 。 举 个 例子 ， 域 模型 程序 集 不 应 该 依赖 对 象 /关系 映射 
库 ， 而 应 该 创建 一 个 独立 的 映射 程序 集 ， 它 包含 了 如 何 指导 对 象 /关系 映射 库 映 射 到 域 模型 的 具 
体 实现 。 这 样 做 ,就 可 以 重用 那些 不 依赖 对 象 关系 映射 库 的 域 模型 核心 类 型 ,更 换 对 象 关系 映射 
库 也 不 会 影响 域 模型 和 客户 端 代码 。 图 2-24 展 示 了 带 有 域 模型 的 逻辑 层 的 一 个 可 能 的 实现 。 











图 2-24 ” 域 模 型 的 程序 集 如 何 协作 来 形成 逻辑 层 


如 有 果 应 用 的 逻辑 比较 复杂 , 比如 是 那些 会 影响 人 们 真实 工作 流 的 业务 规则 , 就 有 必要 为 此 增加 
一 个 逻辑 层 。 邦 外 , 即使 逻辑 不 是 特别 复杂 但 变更 却 很 频 紧 , 也 应 该 引入 逻辑 层 来 封装 这 部 分 逻辑 。 
增加 的 逻辑 层 能 够 简化 用 户 界面 层 以 及 数据 访问 层 的 实现 ， 以 便 它 们 集中 完成 目 身 的 本 职工 作 。 


2.3.2” 纵 切 关 注 点 


有 时 候 , 一 个 组 件 的 职责 很 难 集中 在 单个 层次 内 。 诸 如 审核 、 安 全 以 及 缓存 等 功能 在 应 用 程 
序 的 每 个 逻辑 层 都 有 可 能 存在 。 如 果 无 法 使 用 Visual Studio 调 试 带 单 步调 试 那些 已 经 部 署 到 终端 
机 需 上 的 应 用 代码 ， 可 以 使 用 日 志 手 动 追踪 每 个 方法 在 调用 和 返回 点 处 的 代码 行为 来 辅助 调试 。 
代码 清单 2-23 展 示 了 一 个 记录 方法 的 传人 参数 值 和 返回 值 的 示例 。 


代码 清单 2-23 手动 记录 纵 切 关注 点 可 以 很 快 了 解 到 代码 的 意图 


public void OpenNewAccount(Guid ownerID, string accountName, decimal openingBalance) 


{ 





log.WriteInfo("Creating new account for owner {0} with name '{1}' and an opening 
balance of {2}", ownerID, accountName, openingBalance"); 


using(var transaction = Session.BeginTransaction()) 
{ 
var user = userRepository.GetByID(ownerID); 
user.CreateAccount(accountName); 
var account = user.FindAccount(accountName); 
account.SetBalance(openingBalance); 


transaction.Commit(); 
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} 








示例 中 的 日 志方 式 耗 时 费力 且 容 易 出 错 , 每 个 方法 都 会 出 现 这 些 与 方法 主题 无 关 的 代码 ， 从 
而 导致 有 效 代码 率 降低 。 更 好 的 方式 应 该 是 把 这 些 提取 出 的 纵 切 关注 点 进行 封装 并 以 一 种 更 优雅 
的 方式 应 用 到 源 代 码 中 。 面 癌 切 面 编程 ( Aspect-Oriented Programming, AOP ) 是 一 种 很 常见 的 
增加 功能 的 优雅 方式 。 

1. 切面 

面向 切面 编程 是 代码 中 路 层次 的 纵 切 关 注 点 〈 也 称 为 切面 ) 的 运用 。.NET Framework 有 多 
个 面向 切面 编程 库 以 供 选择 〈 可 以 使 用 NuGet 搜 索 AOP ), 但 是 下 面 的 示例 使 用 的 是 PostSharp， 
它 有 个 免费 但 受 限 的 版 本 可 用 。 代 码 清单 2-24 展 示 了 如 何 使 用 PostSharp 定 义 的 扩展 属性 追踪 代 
码 行为 。 
代码 清单 2-24 ”切面 是 个 实现 纵 切 关注 点 的 好 方式 


[Logged] 
[Transactional] 
public void OpenNewAccount(Guid ownerID, string accountName, decimal openingBalance) 
{ 
var user = userRepository.GetByID(ownerID); 
user.CreateAccount(accountName); 
var account = user.FindAccount(accountName); 
account.SetBalance(openingBalance); 


} 








附加 在 OpenNewAccount 方 法 上 的 两 个 扩展 属性 提供 了 与 代码 清单 2-23 一 样 的 功能 ,但 是 明 
显 更 优雅 简洁 。Logged 属 性 能 够 将 方法 调用 及 其 参数 值 记录 到 日 志文 件 中 。Transactional1 属 
性 实现 了 数据 库 事 务 处 理 功 能 ， 如 果 动 作成 功 就 提交 事务 ， 如 果 失 败 就 会 回 深 事 务 。 这 两 个 属性 
的 最 大 优势 就 是 它们 能 够 应 用 于 任何 方法 ,而 不 仅仅 局 限于 示例 中 的 这 个 方法 , 因此 这 种 属性 可 
以 在 代码 中 大 量 重用 。 


2.3.3” 非 对 称 分 层 


所 有 用 户 的 请 求 都 是 通过 应 用 的 用 户 界 面 传达 的 , 然而 , 收 到 请 求 后 的 处 理 过 程 不 一 定 完全 
相同 。 取决 于 请 求 类 型 ,分 层 也 可 以 是 非 对 称 的 。 恰当 的 分 层 要 考虑 是 否 对 于 人 处理 有 些 请 求 太 过 
复杂 或 不 足 ， 还 要 考虑 是 否 实用 。 

最 近 几 年 ， 命 令 /查询 职责 分 离 (Command/Query Responsibility Segregation，CQRS ) 这 种 非 
对 称 分 层 模式 变 得 很 流行 。 下 面 在 讲解 命令 /查询 职责 分 离 这 个 架构 模式 之 前 ， 需 要 先 讨论 一 个 
方法 层次 的 基础 原则 : 命令 /查询 分 离 ( Command/Query Separation，CQS)。 

1. 命令 /查询 分 离 

命令 /查询 分 离 是 Bertrand Meyer 在 其 著作 Object-Oriented Sofiware Construction( 1997 年 由 
Prentice Hall 出 版 ) 中 首次 提出 的 一 个 方法 层次 的 原则 ， 它 认为 任 一 对 象 方法 要 么 是 命令 ， 要 人 么 
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是 查询 。 
命令 是 对 动作 的 强制 调用 , 需要 代码 做 某 些 动作 。 这 种 命令 方法 可 以 改变 某 些 系统 状态 但 不 
返回 值 。 代码 清单 2.25 展 示 了 两 个 命令 方法 , 第 一 个 符合 命令 /查询 分 离 原 则 , 第 二 个 则 不 符合 。 


代码 清单 2-25 一 个 符合 命令 /查询 分 离 原则 的 命令 方法 和 为 一 个 不 符合 命令 /查询 分 离 原 则 的 合 
I 


// Compliant command 
Public void SaveUser(string name) 


{ 








session.Save(new User(name)); 
} 
// Non-compliant command 
public User SaveUser(string name) 


{ 
var user = new UserCname) ; 
session.Save(user); 
return user; 

} 








查询 是 对 数据 的 请 求 , 需要 代码 获取 茶 些 数据 。 这 种 查询 方法 为 客户 问 代 码 返 回 数据 但 个 应 
改变 任何 系统 状态 。 代 码 清 单 2-26 展 示 了 两 个 查询 方法 , 第 一 个 符合 命令 /查询 分 离 原则 , 第 二 个 
则 不 符合 。 


代码 清单 2-26 一 个 符合 命令 /查询 分 离 原则 的 查询 方法 和 男 一 个 不 符合 命令 /查询 分 离 原则 的 查 
询 方 法 


// Compliant query 
Public IEnumerable<User> FindUserByID(Guid userID) 
{ 
return session.Get<User>(userID); 
} 
// Non-compliant query 
public IEnumerable<User> FindUserByID(Guid userID) 
{ 
var User = session.Get<User>(userID); 
user.LastAccessed = DateTime .Now; 
return user; 


} 


命令 方法 和 查询 方法 签名 上 的 唯一 区 别 就 是 有 无 返回 值 。 如 果 一 个 符合 命令 /查询 分 离 原 则 
的 方法 返回 一 个 值 , 那么 你 就 可 以 大 胆 假设 该 方法 不 会 改变 任何 系统 对 象 状态 。 这 样 做 带 来 的 一 
个 优势 就 是 ,你 可 以 任意 调整 查询 方法 的 顺序 ， 因 为 它们 对 对 象 状态 没有 任何 影响 。 如 果 一 个 符 
合 命令 /查询 分 离 原 则 的 方法 没有 返回 值 ， 你 就 可 以 认为 它 改变 了 对 象 的 状态 。 对 于 命令 方法 ， 
你 需要 留意 不 要 随意 改变 它们 的 调用 顺序 。 

2. 命令 /查询 职责 分 离 

命令 /查询 职责 分 离 模式 是 由 Greg Young 首 先 提 出 的 。 命 令 / 查 询 职责 分 离 模式 是 方法 层次 上 
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的 命令 /查询 分 离 原 则 在 架构 层 上 的 应 用 ， 也 是 一 种 常见 的 非 对 称 分 层 模式 。 基 于 命令 /查询 分 离 
原则 ,命令 /查询 职 贡 分 离 模 式 提出 : 命令 和 查询 可 能 需要 以 不 同 的 路 径 通过 不 同 的 逻辑 层 达 到 
最 优 处 理 的 效果 。 

举 个 例子 ,人 带 有 域 模型 的 三 层 架 构 可 以 应 用 最 简单 的 命令 查询 职责 分 离 模式 。 此 时 ， 只 有 来 目 
应 用 程序 的 命令 才 会 使 用 域 模 型 ,而 来 自 应 用 程序 的 查询 则 会 跳 过 人 逻辑 层 。 图 2-25 展 示 了 这 个 设计 。 














序列 化 / 
反 序 列 化 


图 2-25 ” 域 模 型 仅 应 该 用 于 处 理 来 自 上 层 的 命令 











查询 数据 通常 需要 足够 快 ， 也 不 保证 具有 事务 一 致 性 : 为 了 及 时 响应 ,不 完整 或 混乱 的 数据 
读 取 是 可 以 接受 的 。 不 同 的 是 ,命令 处 理 通 稼 都 需要 保证 具有 事务 一 致 性 ， 因 此 由 不 同 的 层次 处 
理 命令 和 查询 是 有 意义 的 。 有 些 时 候 ， 数 据 访问 层 也 可 以 区 分 命令 和 查询 。 由 完全 符合 ACID 标 
准 (ACID 是 atomic, consistent, isolated, durable 的 缩写 ， 它 们 的 意思 分 别 是 原子 的 、 一 致 的 、 可 隔 
离 的 和 持久 的 ) 的 数据 库 处 理 命 令 ， 而 简单 的 文档 存储 对 查询 来 说 就 已 经 够 用 了 。 为 了 保证 查询 
结果 最 终 是 一 致 的 ， 可 以 由 命令 层 触发 事件 来 异步 更 新 文档 存储 。 











2.4 总结 


本 章 已 经 展示 了 开发 软件 时 依赖 组 织 可 能 导致 的 严重 问题 。 合理 的 依赖 管理 可 以 为 项 目 囊 来 
长 期 的 健康 、 良 好 的 自 适 应 和 生存 能 力 。 如 果 开 发 人 员 和 鲁莽 地 创建 了 相互 引用 的 类 型 ， 必 然 会 引 
入 乱 作 一 团 的 依赖 关系 ， 这 会 严重 影响 团队 持续 地 定期 交付 业务 价值 的 能 

从 互 有 交互 的 独立 方法 和 类 型 ， 到 程序 集 引 用 ,再 到 架构 层 的 组 件 划分 ,所 有 层次 上 的 依赖 
关系 都 需要 认真 管理 。 开 发 人 员 必 须要 时 刻 警 惕 那些 从 目 己 的 方法 、 类 型 、 程 序 集 或 层 上 汽 漏 的 
错误 依赖 。 

在 某 种 程度 上 , 本 章 是 本 书 很 多 剩余 内 容 的 基础 。 后 续 所 有 章节 还 会 不 断 地 讲解 如 何 编写 可 
维护 的 自 适应 代码 。 当 然 ， 如 果 程 序 集 的 引用 是 一 团 乱 兵 ， 层 接口 对 外 其 露 了 最 底层 的 依赖 ， 那 
么 代码 就 一 定 会 变 得 很 难 测试 、 修 改 和 理解 ,而 此 时 才 去 尝试 使 用 任何 模式 或 最 佳 实践 则 都 已 为 
时 过 晚 。 
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完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 定义 接口 并 识别 接口 与 类 的 主要 区 别 。 

口 在 接口 中 应 用 诸如 适 配 姻 和 策略 等 设计 模式 。 

口 通过 鸭子 类 型 、 混 合 类 型 和 流 接口 等 了 解 接口 的 多 样 性 。 

口 识别 接口 的 局 限 并 实现 变通 方案 。 

口 识别 接口 常见 的 反 模式 和 过 度 使 用 的 情况 。 

接口 是 Microsoft .NET Framework 开 发 中 一 个 非常 强大 的 构件 。 尽 管 关键 字 interface 很 简 
单 , 但 是 它 代 表 了 一 个 非常 强大 的 范式 。 如 果 正 确 应 用 , 接口 定义 的 扩展 点 会 让 你 的 代码 具有 非 
第 好 的 适应 变更 的 能 力 。 然 而 ， 有 些 不 好 的 接口 应 用 方式 还 是 很 常见 的 。 

本 章 会 给 出 接口 和 类 之 间 的 区 别 , 还 会 讲解 如 何 让 二 者 协同 发 挥 最 优 作 用 : 不 但 能 够 防止 实 
现 的 变更 影响 客户 端 代码 ， 还 可 以 充分 利用 多 态 的 能 

本 音 也 会 讲述 接口 的 多 样 性 , 它 是 现代 软件 方案 中 一 个 无 处 不 在 的 强大 工具 。 有 一 些 基于 接 
口 的 强大 设计 模式 ， 如 果 能 够 正确 应 用 ( 配合 本 书 中 讲述 的 其 他 模式 )， 就 可 以 让 代码 变 得 非常 
灵活 ， 也 可 以 很 好 地 适应 敏捷 项 目 所 拥抱 的 需求 变更 。 

然而 , 单单 使 用 接口 并 不 能 解决 所 有 问题 。 只 有 以 正确 的 方式 , 谨慎 且 适 量 地 使 用 接口 才能 
为 项 目 市 来 好 处 。 本 音 会 提 到 一 些 经 党 被 滥用 的 接口 应 用 方式 。 


3.1 接口 是 什么 


接口 定义 了 类 的 行为 , 但 并 不 定义 如 何 实现 行为 。 接 口 和 类 是 不 同 的 概念 , 但 是 接口 需要 一 
个 类 实现 接口 所 定义 的 行为 。 

从 开发 语言 角度 来 看 ,语法 关键 字 interface 定 义 了 接口 ， 这 个 简单 的 关键 字 代 表 了 接口 需 
要 的 一 切 。 从 非 开 发 语言 的 角度 来 看 ,接口 也 由 它们 所 包含 的 特性 定义 ,特性 是 指 接 口 要 表达 和 
启用 的 概念 。 
































3.1.1 语法 





C# 使 用 关键 字 interface 来 定义 接口 。 与 类 一 样 ， 接 口 可 以 包括 属性 、 方 法 和 事件 。 然 而 ， 
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接口 中 的 任何 元 素 都 不 需要 设 定 访问 权限 ， 因 为 它们 默认 都 是 公开 的 ， 实 现 接 口 的 类 必须 以 
pub1ic 方 式 实现 接口 的 所 有 元 素 。 代 码 清单 3-1 展 示 了 一 个 接口 的 声明 和 可 能 实现 。 


代码 清单 3-1 一 个 接口 的 声明 和 实现 


public interface ISimpleInterface 








{ 
void ThisMethodRequiresImplementation(); 
string ThisStringPropertyNeedsImplementingToo 
{ 
get; 
set; 
} 
int ThisIntegerPropertyOnlyNeedsAGetter 
{ 
get; 
} 
public event EventHandler<EventArgs> InterfacesCanContainEventsToo ; 
} 
2 
public class SimpleInterfaceImplementation : ISimpleInterface 
{ 
public void ThisMethodRequiresImplementation() 
{ 
} 
public string ThisStringPropertyNeedsImplementingToo 
{ 
get; 
set; 
} 
public int ThisIntegerPropertyOnlyNeedsAGetter 
{ 
get 
{ 
return this.encapsulatedInteger ; 
} 
set 
{ 
this.encapsulatedInteger = value; 
} 
} 


event EventHandler<EventArgs> InterfacesCanContainEventsToo = delegate { }; 


private int encapsulatedInteger; 
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.NET Framework 不 支持 继承 多 个 基 类 的 概念 ， 但 它 支 持 一 个 类 同时 实现 多 个 接口 。 

理论 上 ， 一 个 类 能 实现 的 接口 数目 并 没有 限制 ， 只 要 根据 项 目 实际 情况 决定 一 个 上 限 即 可 。 
代码 清单 3-2 在 前 面 示例 基础 上 增加 了 一 个 接口 。 
代码 清单 3-2 一 个 类 可 以 实现 多 个 接口 


public interface IInterfaceOne 








{ 
void MethodOneQO; 
} 
0 
public interface IInterfaceTwo 
{ 
void MethodTwoQO; 
} 
2 
public class ImplementingMultipleInterfaces : IInterfaceOne, IInterfaceTwo 
{ 
public void MethodOneQ) 
{ 
} 
public void MethodTwo() 
{ 
} 
} 





一 个 类 可 以 实现 多 个 接口 ， 同 样 ， 多 个 类 也 可 以 实现 同一 个 接口 。 





多 重 继承 
有 些 编程 语言 ， 特 别 是 C++， 支 持 继承 多 个 基 类 的 要 个 念 。 然 而 ，.NETFramework 语 言 不 
允许 这 种 特性 ， 如 果 发 现 有 类 尝试 继承 两 个 或 更 多 基 类 ， 编 译 器 会 给 出 如 图 3-1 所 示 的 警告 
2 Class 'Thelnterface.AttemptedMultiplelinheritance' cannot 
have multiple base classes: Thelnterface.BaseClassOne 
and 'BaseClassTwo' 
图 3-1 编 详 带 会 阻止 多 重 继承 
钻石 继承 问题 
.NET Framework 不 支持 多 重 0 因 之 一 就 是 它 会 引起 钻石 继承 问题 。 当 一 个 类 继承 
于 两 个 或 更 多 包含 相同 方法 的 基 类 时 ， 这 个 派生 类 应 该 使 用 哪个 方法 呢 ? 图 3-2 展 示 了 钻石 


问题 的 UML 图。 
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RootClass 


+RootMethod() 


BaseClassOne BaseClassTwo 


+MethodOne() +MethodTwo() 





AttemptedMultiplelnheritance 


+MethodOne() 


+MethodTwo() 
+WhichRootMethod?() 





图 3-2 ”一 个 展示 了 销 石 继承 问题 的 UML 图 


这 种 情况 下 ，AttemptedMu1tip1eInheritance 类 应 该 继承 哪个 基 类 的 RootMethod 方 
法 ， 是 BaseClassO0ne 类 的 还 是 BaseClassTwo 类 的 ? 正 是 由 于 存在 这 种 歧义 性 ，.NET 
Framework 才 决定 不 支持 类 的 多 重 继承 。 


3.1.2” 显 式 实现 


接口 也 可 以 显 式 实现 。 显 式 实现 与 上 一 方 示例 展示 的 隐 式 实现 是 有 区 别 的 。 代 码 清 单 3-3 展 
示 了 与 前 面 示例 相同 的 类 ， 但 它 是 显 式 实现 了 接口 。 


代码 清单 3-3 ” 显 式 实现 接口 


public class ExplicitInterfaceImplementation : ISimpleInterface 





{ 
public ExplicitInterfaceImplementation() 
{ 
this.encapsulatedInteger = 4; 
} 
void ISimpleInterface.ThisMethodRequiresImplementation() 
{ 
encapsulatedEvent(this, EventArgs.Empty); 
} 


string ISimpleInterface.ThisStringPropertyNeedsImplementingToo 
{ 

get ， 

set; 
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} 
int ISimpleInterface.ThisIntegerPropertyOnlyNeedsAGetter 
{ 

get 

{ 

return encapsulatedInteger ; 

} 
} 
event EventHandler<EventArgs> ISimpleInterface.InterfacesCanContainEventsToo 
{ 

add { encapsulatedEvent += value; } 

remove { encapsulatedEvent -= value; } 
} 


private int encapsulatedInteger; 
private event EventHandler<EventArgs> encapsulatedEvent; 


要 使 用 显 式 实现 的 接口 , 客户 端 代码 引用 的 必须 是 一 个 接口 的 实例 ， 而 不 能 是 接口 实现 类 的 
实例 。 代 码 清单 3-4 展 示 了 显 式 实现 接口 的 引用 方式 。 


代码 清单 3-4 ” 显 式 实现 接口 时 ， 实 现 接口 的 类 实例 是 无 法 看 到 接口 方法 的 


public class ExplicitInterfaceClient 
{ 
public ExplicitInterfaceClient(ExplicitInterfaceImplementation 
implementationReference, ISimpleInterface interfaceReference) 
{ 
// Uncommenting this will cause compilation errors. 
//var instancePropertyValue = 
//implementationReference.ThisIntegerPropertyOnlyNeedsAGetter; 
//implementationReference.ThisMethodRequiresImplementation(Q); 
//implementationReference.ThisStringPropertyNeedsImplementingToo = "Hello"; 
//implementationReference.InterfacesCanContainEventsToo += EventHandler.; 


var interfacePropertyValue = 
interfaceReference.ThisIntegerPropertyOn1yNeedsAGaetter ; 
interfaceReference.ThisMethodRequiresImplementation(); 
interfaceReference.ThisStringPropertyNeedsImplementingToo = "Hello"; 
interfaceReference.InterfacesCanContainEventsToo += EventHandler; 


void EventHandler(object sender, EventArgs e) 


{ 











当 实 现 接口 的 类 与 接口 本 身 有 方法 签名 种 突 时 ， 显 式 实现 接口 的 方式 是 很 有 用 的 。 
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.NET Framework 上 下 文中 的 所 有 方法 都 有 自己 的 签名 。 方法 签名 是 方法 的 标识 ,可 以 用 来 区 
别 不 同 的 方法 ， 防 止 已 有 方法 被 覆 写 。 方 法 签名 包括 方法 名 和 参数 列表 。 注 意 ，.NET Framework 
方法 的 访问 级 别 、 返 回 值 、 抽 象 或 者 密封 状态 等 都 会 影响 最 终 的 方法 签名 ”"。 代 码 清单 3-5 展 示 了 
条 和 干 方法 签名 ,其 中 一 些 会 有 冲突 。 如 果 两 个 方法 的 上 述 几 个 因素 完全 相同 ,那么 它们 的 签名 就 
会 产生 冲突 。 同 一 个 类 、 接 口 或 结构 内 的 方法 之 间 不 允许 存在 签名 冲突 。 


代码 清单 3-5 ”其 中 一 些 方法 签名 存在 冲突 


public class ClashingMethodSignatures 























{ 
public void MethodA() 
{ 
} 
// This would cause a clash with the method above: 
//public void MethodA() 
//i 
//+ 
// As would this: return values are not considered 
//public int MethodA(O) 
//i 
// return 0; 
//+ 
public int MethodB(Cint x) 
{ 
return x; 
} 
// There is no clash here: the parameters differ. 
// This is an overload of the previous MethodB. 
public int MethodB(int x, int y) 
{ 
return x + y; 
} 
} 





属性 本 身 是 没有 参数 列表 的 方法 , 所 以 只 能 用 属性 名 称 来 区 分 。 因 此, 如果 两 个 属性 名 相同 ， 
属性 签名 就 会 产生 冲突 。 
代码 清单 3-6 中 的 类 需要 实现 前 面 提 及 的 接口 InterfaceOne。 








JD 在 方法 重 载 的 上 下 文中 , 方法 签名 不 包括 返回 值 。 而 在 委托 的 上 下 文中 ， 签 名 包括 返回 值 ， 所 以 实现 委托 的 方法 
要 与 委托 的 返回 值 类 一 致 。 一 一 译 者 注 


86 第 3 章 接口 和 设计 模式 





代码 清单 3-6 ”要 实现 接口 的 类 会 与 接口 本 里 产生 方法 签名 冲突 


public class ClassWithMethodSignatureClash 


{ 
public void Methodone () 
{ 
} 

} 








首先 ， 因 为 方法 签名 相同 ， 你 只 需要 直接 在 类 声明 处 加 入 实现 接口 的 标记 ， 如 代码 清单 3-7 
所 未。 


代码 清单 3-7 隐 式 实现 接口 允许 重用 已 经 存在 的 方法 


public class ClassWithMethodSignatureClash : IInterfaceOne 








{ 
public void MethodOneQ) 
{ 
} 

} 








客户 端 代码 在 任何 时 候 调 用 这 个 类 中 的 接口 方法 时 , 都 会 使 用 该 类 定义 的 同名 方法 。 举 个 例 
子 ， 要 在 Windows Forms 中 实现 模型 -视图 -表示 带 (MVP ) 模式 时 ， 以 及 要 添加 需要 Close 方 法 
才能 在 Form 上 实现 的 IView 接 口 时 ， 这 会 很 有 用 。 代 码 清单 3-8 显 示 了 其 实际 情形 。 
代码 清单 3-8 ”有 了 时候 可 以 巧妙 地 利用 方法 签名 冲突 


public interface IView 





{ 
void CloseQO); 
} 
OA 
public partial class Forml : Form, IView 
{ 
public Form1C) 
{ 
InitializeComponent(); 
} 
} 











然而 ， 如 果实 现 接 口 的 类 需要 为 接口 方法 提供 不 同 的 实现 ， 就 必须 要 显 式 实现 接口 的 方法 ， 
从 而 避免 出 现 两 个 签名 冲突 的 方法 体 。 代 码 清 单 3-9 展 示 了 这 种 情况 。 
代码 清单 3-9 ” 显 式 实现 接口 方法 以 避免 与 类 方法 出 现 签名 冲突 


public class ClassAvoidingMethodSignatureClash : IInterfaceOne 


{ 





public void Methodone () 
{ 


// original implementation 
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} 
void IInterfaceOne.MethodOneQ) 
{ 
// new implementation 
} 


} 





类 似 地 ,如 果 一 个 类 需要 实现 两 个 不 相关 但 有 同名 方法 的 接口 , 你 可 以 用 同一 个 方法 体 来 隐 
式 实现 这 两 个 接口 , 或 者 显 式 实现 两 个 接口 ， 为 两 个 接口 分 别提 供 一 个 独立 的 方法 体 。 代 码 清 单 
3-10 展 示 了 这 种 情况 。 


代码 清单 3-10 ”为 两 个 接口 实现 各 自 的 同名 方法 时 ， 只 有 通过 显 式 实现 接口 才能 做 到 


public class ClassImplementingClashingInterfaces : IInterfaceOne, IAnotherInterfaceOne 


{ 








void IInterfaceOne.MethodOne() 
{ 


} 


void IAnotherInterfaceOne.MethodOne() 
{ 


} 
} 


3.1.3 多 态 


一 个 类 型 的 对 象 可 以 隐 式 表现 为 为 外 一 种 不 同类 型 的 能 力 称 为 多 态 ( polymorphism )。 客 户 
端 代码 看 起 来 是 与 一 种 类 型 的 对 象 交 互 , 但 该 对 象 实际 却 是 男 外 一 种 类 型 。 这 种 高 级 手法 是 面 癌 
对 象 编程 中 解决 问题 的 杀手 铜 之 一 ， 它 是 很 多 非常 优雅 且 自 适应 强 的 解决 方案 的 基础 。 

图 3-3 展 示 了 一 个 抽象 了 交通 工具 行为 的 接口 ， 三 个 分 别 为 轿车 、 摩 托 车 和 快艇 实现 该 接口 
的 类 。 这 三 种 交通 工具 有 很 大 的 差异 ， 但 是 它们 都 实现 了 同一 个 接口 定义 的 行为 。 

在 这 个 示例 里 ， 假 设 交 通 工 具有 可 以 启 停 的 引擎 ， 可 以 转向 ， 能 够 加 速 。 多 态 能 让 引用 
IVehicle 接 口 的 客户 端 代码 把 所 有 具体 类 型 都 看 作 是 相同 的 接口 。 至 于 轿车 和 摩托 转向 或 加 速 
的 不 同 之 处 , 或 者 快艇 和 火车 引 敬 启动 和 停止 的 不 同 之 处 , 都 与 调用 交通 工具 接口 的 客户 站 代码 
无 关 。 多 态 在 编程 开发 中 是 一 个 极为 有 用 的 能 力 。 在 现实 生活 当中 ， 当 需要 交通 工具 时 ,我 们 也 
都 是 交通 工具 接口 的 客户 端 。 当 然 ， 上 面 示例 中 的 接口 定义 比 起 实际 的 交通 工具 定义 还 差 很 远 ， 
不 过 原则 都 是 一 样 的 。 只 有 知道 汽车 引擎 工作 原理 的 人 才能 开车 吗 ? 当然 不 是 。 是 否 清楚 诸如 引 
擎 局 停 等 工作 原理 的 细节 不 会 对 笃 驶 人 的 开车 技能 有 任何 影响 。 这 就 是 非常 好 的 接口 设计 。 

本 章 剩 余部 分 会 继续 讲解 有 助 于 编写 出 自 适 应 代码 的 设计 模式 和 接口 特性 ,多 态 是 这 些 设计 
模式 和 接口 特性 的 基础 , 它 能 让 每 个 实现 既定 接口 的 类 都 变 得 有 用 , 无 论 这 些 类 已 经 写 好 或 仍 在 
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<<|NTERFACE> > 
IVehicle 


+StartEngine() 
+StopEngine() 
+Steer() 

+Accelerate() 





Motorcycle Speedboat 


+StartEngine() +StartEngine() +StartEngine() 
+StopEnginel() +StopEnginel() +StopEngine() 


+9teer() +Steer() +9teer() 
+Accelerate() +Accelerate() +Accelerate() 





图 3-3 ”接口 把 行为 传递 给 所 有 实现 它 的 类 以 形成 多 态 的 能 力 


3.2 ”月 适应 设计 模式 


“四 人 组 ” “所 著 的 《设计 模式 : 可 复 用 面向 对 象 软件 的 基础 一 书 让 设计 模式 变 得 非常 流行 。 
虽然 这 本 书 已 经 出 版 了 二 十 多 年 ( 对 软件 开发 界 而 言 ， 二 十 多 年 至 少 相当 于 四 个 冰河 时 代 了 )， 
但 在 今天 看 来 依然 有 着 极 高 的 价值 。 虽然 其 中 有 些 模式 已 经 被 归 类 到 反 模 式 当 中 , 但 是 其 余 的 模 
式 依然 能 够 很 大 程度 上 提升 代码 的 变更 适应 能 

好 的 设计 模式 是 接口 和 类 之 间 可 重用 设计 的 精华 ， 它 们 可 以 反复 应 用 在 很 多 不 同 的 场景 中 ， 
并 且 与 项 目 、 平 台 、 语言 和 框架 无 关 。 与 很 多 著名 的 最 佳 实践 一 样 ， 了 解 设计 模式 这 个 理论 工具 
要 比 对 它 一 无 所 知 要 好 得 多 。 但 是 它们 也 可 能 会 被 滥用 ， 也 会 不 适合 某 些 场合 。 有 时 ， 与 简单 方 
案 相 比 ， 它 会 因为 引入 过 多 的 类 、 接 口 、 间 接 层 和 抽象 而 变 得 太 过 复杂 。 

经 验 告诉 我 ,设计 模式 很 容易 被 忽视 或 滥用 。 有 些 项 目 几乎 没 应 用 什么 设计 模式 ， 代 码 也 看 
不 出 明确 的 结构 设计 。 另 外 一 些 项 目 则 不 受 限 制 地 使 用 设计 模式 ， 引 入 了 过 多 的 中 间 层 和 抽象 ， 
以 至 于 和 得不偿失。 正确 的 应 用 方式 应 该 是 在 正确 的 场合 使 用 正确 的 模式 。 


3.2.1 空 对 象 模式 


空 对 象 模式 是 一 种 最 常见 的 设计 模式 , 也 是 一 种 最 容易 理解 和 实现 的 设计 模式 。 它 能 让 你 避 
免 引 发 意外 的 Nul11ReferenceException 异 常 ,也 无 需 到 处 检查 对 象 是 否 为 nu11。 图 3-4 中 的 UML 





























Qa 四 位 作者 分 别 是 Erich Gamma、Richard Helm、Ralph Johnson 和 John Vlissides。 
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类 图 展示 了 空 对 象 模式 的 应 用 方式 。 


<<INTERFACE>> 
IAbstraction 


+Request() 


实际 对 象 














+Request() +Request() 


图 3-4 ”使 用 UML 类 图 表达 空 对 象 模式 


代码 清单 3-11 展 示 了 典型 的 会 引发 Nu11ReferenceException 异 常 的 代码 。 


代码 清单 3-11 ”如果 不 检查 返回 值 是 否 为 nu11， 就 有 可 能 引发 Nu11ReferenceException 异 常 


class Program 


{ 
static IUserRepository UserRepository = new UserRepository() ; 
static void Main(string[] args) 
{ 
var user = userRepository.GetByID(Guid.NewGuid()); 
// Without the Null Object pattern, this line could throw an exception 
user.IncrementSessionTicket(); 
} 
} 


所 有 调用 IUserRepository.Get(Guid uniqueID) 方 法 的 客户 端 代码 都 有 3 引发 nu11 引 用 异 
常 的 危险 。 在 实践 中 ， 每 个 客户 端 都 必须 检查 返回 值 是 否 为 nu11， 以 避免 解析 nu11 引 用 ， 因 为 
后 者 会 引发 Nu11ReferenceException 异 常 。 检 查 返 回 值 是 否 为 nu11 的 客户 端 代码 如 代码 清单 
3-12 所 示 。 


代码 清单 3-12 ”检查 值 是 否 为 nu11 仍 是 所 有 客户 端的 职责 吗 


class Program 


{ 








static IUserRepository UserRepository = new UserRepository() ; 


static void Main(string[] args) 


{ 
var user = userRepository.GetByID(Guid.NewGuid()); 
ifCuser != null) 
{ 


user.IncrementSessionTicket(); 


} 
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} 


仿 查 对 象 值 是 否 为 空 表明 你 让 所 有 IRespository 的 客户 端 代 码 都 做 了 太 多 不 必要 的 工作 。 
用 这 个 方法 的 客户 越 多 ， 走 记 检 查 nu113 引 用 的 可 能 性 越 大 。 相 反 ， 你 应 该 让 产生 问题 的 源头 来 
完成 检查 工作 ， 如 下 面 的 代码 清单 3-13 所 示 。 
代码 清单 3-13 ”服务 代码 应 该 实现 空 对 象 模式 


public class UserRepository : IUserRepository 





{ 
public UserRepositoryQ 
{ 
users = new List<User> 
{ 
new User(Guid.NewGu1idQO), 
new User(Guid.NewGu1idO), 
new User(Guid.NewGuidO), 
new User (Guid.NewGuid()) 
bs 
} 
public IUser GetByID(Guid userID) 
{ 
IUser userFound = users.SingleOrDefault(user => User.ID == UserID) ; 
if(userFound == null) 
{ 
userFound = new NullUserQO; 
} 
return userFound; 
} 
private ICollection<User> users; 
} 


首先 , 这 段 代码 试图 从 一 个 内 存 中 的 集合 中 获取 指定 有 D 的 User, 这 与 第 2 章 中 的 实现 是 一 样 的 。 
但 是 ， 现 在 你 要 做 的 是 检查 返回 的 User 实 例 是 否 为 nu11 引 用 ， 如 果 是 ， 你 返回 一 个 特殊 的 IUser 
的 派生 类 型 : Nu11User。 这 个 子 类 重 写 的 IncrementSessionTicket 方 法 实际 上 什么 都 没 做 ， 如 代 
码 清单 3-14 所 示 。 实 际 上 ， 正 确 的 Nu11User 实 现 所 重 写 的 所 有 方法 都 应 该 尽量 什么 都 不 做 。 


代码 清单 3-14 NullUser 方 法 实现 什么 都 不 做 


public class NullUser : IUser 





{ 
public void IncrementSessionTicket() 
{ 
// do nothing 
} 
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此 外 ， 如 果 Nul11User 对 和 象 的 属性 或 方法 要 返回 另 一 个 对 象 的 引用 ， 也 应 该 返回 这 些 类 型 的 
特殊 空 对 象 实现 。 换 句 话 说 ， 所 有 空 对 象 实现 都 应 该 递归 返回 空 对 象 实现 。 这 样 做 后 ， 客 户 端 代 
码 就 无 需 检 查 nu11 引 用 了 。 

这 样 做 的 另外 一 个 好 处 就 是 , 可 以 减少 需要 的 单元 测试 数目 。 如 果 不 应 用 空 对 象 模式 ， 每 个 
客户 端 代码 都 要 自己 检查 空 引 用 , 那么 也 就 要 有 对 应 的 单元 测试 来 判断 是 否 进 行 空 对 象 测试 。 相 
反 ， 会 对 存储 库 实 现 进行 做 单元 测试 以 确保 它 返 回 Nu11User 实 现 。 

IsNu]11 属 性 反 模 式 

有 时 候 空 对 象 模式 会 给 接口 引入 一 个 名 为 IsNu11 的 布尔 型 属性 。 该 接口 的 所 有 具体 实现 都 
会 使 这 个 属性 返回 值 不 为 真 ， 只 有 接口 的 空 对 象 实现 返回 值 为 真 。 代 码 清 单 3-15 基 于 前 面 示例 展 
示 了 IsNu11 属 性 。 


代码 清单 3-15 ”只 有 接口 的 空 对 象 实现 的 IsNu11 属 性 值 为 真 


public interface IUser 





























{ 
void IncrementSessionTicket(); 
bool IsNull 
{ 
get; 
} 
} 
0 
public class User : IUser 
{ 
/Ek 
public bool IsNull 
{ 
get 
{ 
return false; 
} 
} 
private DateTime sessionExpiry; 
} 
/NR 
public class NullUser : IUser 
{ 
public void IncrementSessionTicket() 
{ 
// do nothing 
} 
public bool IsNull 
{ 
get 
{ 


return 七 Pue 
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IsNu11 模 式 的 问题 在 于 它 会 让 本 应 封 效 行为 的 对 旬 人 名 上 自身 的 逻辑 。 比 如 ,需要 在 客户 端 代 
码 中 引入 话语 名 来 分 别处 理 真正 的 实现 和 空 对 象 实现 。 这 违背 了 空 对 象 模式 的 设计 初衷 : 避免 把 
自己 的 逻辑 扩散 到 它 的 客户 端 代码 中 。 代码 清单 3.16 是 这 个 问题 的 一 个 典型 示例 。 
代码 清单 3-16 ”基于 IsNu11 属 性 的 逻辑 使 之 成 为 一 种 反 模 式 


static void Main(string[] args) 


{ 
var user = UserRepository.GetByID(Guid.NewGuid()); 
// Without the Null Object pattern, this line would throw an exception 
user.IncrementSessionTicket(); 
string UserName ; 
if(!user.IsNull) 
{ 
UserName = user.Name; 
} 
else 
{ 
userName = "unknown"; 
} 
Console.WriteLine("The user's name is {0}", userName); 
Console.ReadKey(); 
} 


通过 让 Nu1l1lUser 封 装 一 个 空 用 户 名 称 ， 就 可 以 去 除 上 面 示例 中 的 不 必要 的 ff 语句。 如 代码 
清单 3-17 所 示 。 


代码 清单 3-17 ”经 过 合适 的 封装 后 ，IsNu11 属 性 被 废弃 了 


public class NullUser : IUser 


{ 
public void IncrementSessionTicket(Q) 
{ 
// do nothing 
} 
public string Name 
{ 
get 
{ 
return "unknown"; 
} 
} 
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OA 

static void Main(string[] args) 

{ 
var user = userRepository.GetByID(Guid.NewGuid()); 
// Without the Null Object pattern, this line would throw an exception 
user.IncrementSessionTicket(); 
Console.WriteLine("The user's name is {0}", user.Name); 
Console.ReadKey() ; 

} 


级 联 空 值 
C# 语 言 有 一 个 模拟 Groovy" 的 特性 , 它 提供 了 “级 联 空 值 ” 运算 符 。 考虑 下 面 的 代码 片段 。 
if(person != null && person.Address != null && person.Address.Country == "England") 
E 人 
} 


它 可 以 简化 为 以 下 代码 。 


if(person?.Address?.Country == "England") 
{ 

本 
} 


因此 , 运算 符 ?. 成 为 了 一 种 安全 解析 引用 任何 对 象 的 方式 ,因为 在 最 糟糕 的 情况 下 , 也 
会 有 属性 类 型 的 defau1t(T) 来 处 理 引 用 解析 。 我 虽然 不 反对 任何 其 他 人 或 许 认 为 有 用 的 语 
法 改进 ， 但 是 拿 ? ,与 空 对 象 实现 作 比 较 ， 我 还 是 会 选择 后 者 ， 三 个 理由 如 下 。 

第 一 ,很 多 情况 下 ， 只 有 一 个 简单 的 类 默认 值 是 不 能 满足 需求 的 。 上 面 示例 中 使 用 一 个 
有 意义 的 名 称 来 避免 引发 Nu11ReferenceException 异 常 证 明了 Unknown 不 是 一 个 默认 值 ， 
而 是 对 应 用 更 有 意义 的 数据 。 

第 二 ， 使 用 ? .运算 符 还 是 会 让 所 有 客户 端 代 码 操 心 可 能 会 出 现 nu11 值 。 使 用 空 对 象 模 
式 的 部 分 原因 就 是 能 够 避免 nu11 检 查 并 让 客户 端 代码 放心 自由 地 解析 引用 。 如 果 你 选择 级 
联 空 值 语 法 ， 那 么 有 可 能 让 自己 忘记 去 做 引用 解析 。 

第 三 ， 一 个 更 主要 的 原因 是 ， 这 种 语法 会 在 代码 中 泛滥 成 灾 。 偶 尔 使 用 int? 来 表示 一 
个 带 有 可 选 引用 语法 的 int 还 可 以 接受 ， 但 是 如 果 需 要 代码 中 每 个 引用 解析 的 地 方 加 上 ?. 运 


算 符 ， 我 想 还 是 算 了 吧 。 
如 果实 现 了 适合 的 空 对 象 实现 ， 上 面 的 代码 可 以 像 如 下 所 示 一 样 更 简洁 。 


Q) Groovy 是 一 种 基于 Java 的 动态 编程 语言 ( http://groovy.codehaus.org )。 
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if(person.Address.Country == "England") 
{ 

/过 
} 


这 样 编写 代码 的 最 大 好 处 就 是 : 客户 端 代码 能 专心 完成 自身 的 业务 , 根本 不 用 担心 可 能 
会 引发 Nu11ReferenceException 异 常 。 


3.2.2 ”适配器 模式 


适 配 需 模式 允许 你 为 客户 端 提供 一 个 接口 的 实例 对 象 , 而 该 对 象 并 未 真正 实现 这 个 接口 。 换 名 
话说 , 适 配 需 类 实现 了 客户 端 期 望 的 接口 , 但 是 接口 方法 的 具体 实现 则 委托 给 另外 一 个 对 象 的 不 同 
方法 来 完成 。 这 种 模式 通常 用 于 目标 类 无 法 更 改 为 期 望 接 口 的 场合 , 因为 目标 类 可 能 是 密封 的 或 者 
根本 无 法 获得 该 类 的 源 代 码 。 适 配器 模式 有 两 种 实现 方式 : 类 适配器 模式 或 对 象 适配器 模式 。 

1. 类 适配器 模式 

图 3-5$ 展 示 了 类 适 配 需 模式 中 相互 协作 的 类 和 接口 



























被 适 配 者 


-dependency MethodB() ~ 







: +MethodA() 
+Dosomething() +MethodB() 





dependency.MethodA 
图 3-5 ”类 适 配 带 的 UML 图 
类 设 配 带 模 式 利用 了 适 配 带 的 继承 ,目标 类 的 子 类 被 适 配 为 客户 端 所 期 望 的 接口 。 代 码 清 
3-18 展 示 了 类 适 配 各 的 实际 应 用 。 
代码 清单 3-18 ”类 适 配 帮 模式 利用 了 实现 的 继承 关系 


public class Adaptee 

{ 
public void MethodBO 
{ 








} 
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AN 
public class Adapter : Adaptee 
{ 
public void MethodA() 
{ 
MethodBO; 
} 
} 
0 
class Program 
{ 
static Adapter dependency = new Adapter() ; 
static void Main(string[] args) 
{ 
dependency .MethodA(); 
} 
} 


这 种 方式 不 如 对 象 适 配 大 模式 常用 , 因为 开发 人 员 更 倾向 于 使 用 组 合 而 不 是 继承 。 这 是 因为 
继承 是 一 种 白 盒 〈《whitebox ) 重用 ， 子 类 会 依赖 基 类 的 实现 而 不 是 接口 。 组 合 则 是 一 种 黑 盒 
( blackbox ) 重用 ， 它 把 依赖 局 限 在 接口 上 ， 从 而 避免 实现 变更 对 客户 端 代 码 的 影响 。 

2. 对 象 适 配器 模式 

对 象 适 配 融 模 式 使 用 组 合 委托 一 个 黑 盒 实例 对 象 来 实现 接口 方法 。 图 3-6 展 示 了 对 象 适 配 天 
模式 中 协作 的 类 和 接口 。 
























-dependency 


+Dosomething() 


dependency.MethodAl() ~ 


~N 
target.MethodB() +MethodA0 +MethodB() 


图 3-6 “对象 适 配 需 模 式 的 UML 图 
代码 清单 3-19 展 示 了 对 象 适 配 需 模式 的 应 用 示例 。 
代码 清单 3-19 适 配 需 将 目标 类 作为 构造 另 数 参数 ， 并 委托 它 实现 接口 


public interface IExpectedInterface 


{ 





void MethodA(C) ; 
} 
OCR 
public class Adapter : IEXxpectedInterface 
{ 
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public Adapter(TargetClass target) 


{ 
this.target = target; 
} 
public void MethodAQO 
{ 
target .MethodB() ; 
} 
private TargetClass target; 
} 
Yh 
public class TargetClass 
{ 
public void MethodBO 
{ 
} 
} 
”Re 
class Program 
{ 
static IExpectedInterface dependency = new Adapter(new TargetClass()); 
static void Main(string[] args) 
{ 
dependency .MethodA(); 
} 
} 


3.2.3 ”策略 模式 


策略 模式 能 够 在 不 需要 重新 编译 的 情况 下 ( 甚至 在 运行 期 间 也 可 以 ) 改变 类 的 行为 。 图 3-7 
中 的 UML 图 展示 了 策略 模式 的 结构 。 
策略 模式 可 以 用 于 需要 根据 某 个 对 象 状态 展示 可 变 行 为 的 类 。 如 果 类 实例 的 行为 会 根据 当前 











状态 变化 ， 此 时 使 用 策略 模式 封装 这 些 可 变 行为 就 是 最 好 不 过 的 了 。 代 码 清单 3-20 展 示 了 如 何在 


<<|NTERFACE> > 
IStrategy 


一 个 类 上 创建 和 应 用 策略 模式 的 代码 。 


+Execute() 





1 
一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 儿 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 


I 1 
I I 
1 
StrategyA StrategyB 


+Execute() +Execute() 





图 3-7 策略 模式 的 UML 图 
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代码 清单 3-20 ” 素 略 模式 的 用 途 


public interface IStrategy 





{ 
void Execute(); 
} 
/Ne 
public class ConcreteStrategyA : IStrategy 
{ 
public void Execute() 
{ 
Console.WriteLine("ConcreteStrategyA.Execute()"); 
} 
} 
/ee 
public class ConcreteStrategyB : IStrategy 
{ 
public void Execute() 
{ 
Console.WriteLine("ConcreteStrategyB.Execute()"); 
} 
} 
/re 
public class Context 
{ 
public Context() 
{ 
currentStrategy = strategyA; 
} 
public void DoSomething() 
{ 
currentStrategy .Execute(); 
// swap strategy with each call 
currentStrategy = (currentStrategy == strategyA) ? strategyB : strategyA; 
} 
private readonly IStrategy strategyA = new ConcreteStrategyAQ; 
private readonly IStrategy strategyB = new ConcreteStrategyBQO; 
private IStrategy currentStrategy; 
} 





Context.DoSomething() 方 法 首先 委托 当前 策略 A 人 做事， 然后 切换 到 男 外 一 个 策略 B。 下 一 
次 对 该 方法 的 调用 会 委托 切换 后 的 策略 B 做 事 ， 然 后 再 次 切换 回 原 来 的 策略 A， 如 此 反复 。 

上 面 示例 中 , 虽然 选择 策略 的 方式 是 包含 在 具体 的 方法 实现 中 , 但 它 并 没有 违背 策略 的 实际 
作用 : 接口 隐藏 行为 ， 接 口 的 实现 完成 该 行为 定义 的 具体 工作 。 
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3.3 更 多 形式 


不 只 是 设计 模式 在 利用 接口 的 强大 能 力 ， 还 有 其 他 更 多 特殊 的 接口 应 用 方式 也 值得 深入 探 
讨 。 虽 然 这 些 方式 并 不 是 次 适 的， 但 是 在 一 些 特殊 的 场合 它们 会 是 最 佳 的 选择 。 

与 设计 模式 一 样 , 滥用 ( overuse ) 这 些 特殊 的 接口 应 用 方式 会 影响 代码 的 可 读 性 和 可 维护 性 。 
但 是 ,实际 应 用 中 , 很 难为 解决 问题 定 出 一 个 具体 的 使 用 模式 和 其 他 技术 方法 的 最 佳 次 数 ， 因 此 
在 使 用 下 面 要 介绍 的 这 些 方法 时 一 定 要 谨慎。 


3.3.1 晃 子 类 型 


C# 是 一 个 静态 类 型 语言 ， 而 蝎子 类 型 ( duck-typing ) 则 是 动态 类 型 语言 的 一 个 特性 ， 可 以 使 
用 下 面 的 鸭子 测试 《duck test ) 进行 验证 。 
如 果 我 看 到 一 只 乌 ， 它 走 起 来 像 鸣 子 ， 游 泳 时 像 网 子 ， 叫 起 来 也 像 鸭 子 ， 
那么 我 就 认为 它 是 只 鸭子 。 











一 一 James Whitcomb Riley 
在 编程 语言 中 ,鸭子 测试 建议 : 只 要 对 象 展示 了 某 个 特性 接口 的 行为 ,那么 就 应 该 看 成 该 接 
口 的 实例 。 不 注 的 是 ，C# 默 认 的 情况 并 不 是 这 样 。 如 代码 清单 3-21 所 示 。 
代码 清单 3-21 尽管 对 象 Swan 实 现 了 IDuck 的 所 有 方法 ， 但 实际 上 它 不 是 一 个 IDuck 


public interface IDuck 


{ 








void WalkQO; 
void Swim(); 


void Quack QO; 
} 
se 
public class Swan 
{ 
public void WalkO) 


{ 
Console.WriteLine("The swan is walking."); 
} 
public void Swim() 
{ 
Console.WriteLine("The swan can swim like a duck."); 
} 


public void Quack() 
{ 
Console.WriteLine("The swan is quacking."); 


} 
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} 
7 
class Program 
{ 
static void Main(string[] args) 
{ 
var swan = new SwanQO; 
var swanAsDuck = swan as IDuck; 
if(swan is IDuck || swanAsDuck != null) 
{ 
swanAsDuck.WalkQO; 
swanAsDuck. SwimO); 
swanAsDuck.QuackO; 
} 
} 
} 


is 谓 词 和 as 转 换 会 分 别 返 回 false 和 nu11。 公共 语言 运行 时 ( CLR ) 并 不 会 把 Swan 看 作 一 个 
IDuck， 即 使 swan 实际 上 实现 了 该 接口 。 类 型 只 能 通过 接口 继承 来 实现 接口 。 

有 一 些 技巧 能 让 Swan 类 在 无 需 实现 IDuck 接 口 的 情况 下 用 作 该 接口 的 实例 。 你 可 以 利用 新 版 
公共 语言 运行 时 中 引入 的 动态 类 型 特性 ， 或 使 用 一 个 名 为 Inpromptu Interface 的 第 三 方 库 。 

1. 使 用 动态 语言 运行 时 

从 版 本 4 开始 ，.NET Framework 就 不 再 是 严格 的 静态 类 型 平台 了 ， 它 引入 了 dynami c 关 键 字 
及 其 一 些 配套 的 文 持 类 型 以 文 持 切换 到 动态 类 型 的 动态 语言 运行 时 (DynamicLanguageRuntime， 
DLR )。 下 面 的 代码 清单 3-22 展 示 了 C# 中 的 动态 类 型 的 一 个 例子 。 


代码 清单 3-22 ”动态 语言 运行 时 可 以 应 用 在 鸭子 类 型 上 


class Program 











{ 
static void Main(string[] args) 
{ 
var swan = new SwanQO; 
DoDuckLikeThings (swan); 
Console.ReadKey() ; 
} 
static void DoDuckLikeThings(dynamic duckish) 
{ 
if (duckish != nul1) 
{ 
duckish.Walk(C) ; 
duckish.Swim() ; 
duckish.Quack QO; 
} 
} 
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然而 , 需要 注意 的 是 ， 示例 中 方法 参数 是 dynamic 类 型 的 。 为 此 ,不 仅 你 的 代码 需要 以 .NET 
Framework 4 为 目标 框架 ， 客 户 端 代 码 也 需要 文 持 动态 类 型 。 让 两 者 都 支持 动态 类 型 ， 有 时 候 不 
太 现 实 。 比 如 ， 你 创建 的 所 有 方法 全 都 采用 dynami c 人 参数 ， 如 果 要 这 样 的 话 ， 还 不 如 直接 选择 诸 
如 IronPython "等 支持 .NET Framework 的 动态 类 型 语言 。 

2. 使 用 Impromptu Interface 库 

Impromptu Interface 是 一 个 .NET Framework 库 。 使 用 NuGet 安 装 好 它 后 ， 就 可 以 使 用 它 提供 的 
ActLike<T> 0O) 方 法 将 传人 的 Swan 类 实例 转化 为 一 个 IDuck 接 口 实例 。 代 码 清 单 3-23 展 示 了 这 种 
转换 。 


代码 清单 3-23 ”Impromptu Interface 能 够 在 C# 中 支持 动态 类 型 


class Program 


{ 








static void Main(string[] args) 
{ 


var swan = new Swan() ; 
var swanAsDuck = Impromptu.ActLike<IDuck>(swan); 


if(swanAsDuck != null) 
{ 
swanAsDuck .WalkQO; 
swanAsDuck .Swim(); 
swanAsDuck .Quack() ; 
} 


Console.ReadKey() ; 


} 


ActLike 方 法 会 在 运行 时 会 使 用 Reflection Emit 创 建 一 个 新 的 类 型 。 该 类 型 会 实现 IDuck 接 口 
并 将 Swan 类 实例 作为 内 部 数据 成 员 进 行 封装 。 任何 对 IDuck 方 法 的 调用 , 都 会 直接 委托 到 该 Swan 
类 实例 。Impromptu Interface 实 际 上 是 在 运行 时 应 用 对 象 适 配 髓 模式 ， 这 里 要 感谢 强大 的 .NET 
Framework,， 因为 它 的 反射 特性 文 持 能 够 在 运行 时 创建 新 的 类 型 。Impromptu Interface 是 应 用 对 象 
适 配 郑 模式 的 一 种 目 动 方式 。 

3. 公共 语言 运行 时 对 鸭子 类 型 的 支持 

有 趣 的 是 , 公共 语言 运行 时 实际 上 有 支持 鸭子 类 型 的 能 力 , 但 只 是 应 用 在 一 个 不 大 常用 的 场 
合 : 实现 可 枚 举 的 对 象 。 人 允许 foreach 循 环 枚 举 的 类 必须 遵守 一 个 特定 的 接口 ， 但 该 接口 的 应 用 
方式 并 不 标准 ,目标 类 根本 不 需要 显 式 继承 于 该 接口 ,自己 组 织 实现 接口 定义 的 方法 即 可 。 如 代 
码 清 单 3-24 所 示 ，Duck 类 人 允许 foreach 循 环 枚 举 。 

















GD http://ironpython.net 
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代码 清单 3-24 ”CLR 隐 式 对 可 枚 举 类 支持 网 子 类 型 


class Program 





{ 
static void Main(string[] args) 
{ 
var duck = new Duck QO; 
foreach (var duckling in duck) 
{ 
Console.WriteLine("Quack {0}", duckling); 
} 
Console.ReadKey() ; 
} 
} 





Duck 类 没有 实现 任何 接口 ， 但 是 foreach 循 环 在 编译 时 会 去 通过 Duck 实 例 调 用 
GetEnumerator() 方 法 ， 如 图 3-8 所 示 。 


Description 


多 1 foreach statement cannot operate on variables of type 
‘Thelnterface.Duck' because 'Thelnterface.Duck' does not 
contain a public definition for 'GetEnumerator' 


图 3-8 ”类 并 没有 被 要 求 继承 某 个 特定 的 接口 ， 但 是 编译 咒 会 给 出 该 类 缺失 一 个 公共 方 
法 的 警告 





在 Duck 类 中 实现 了 返回 void 的 GetEnumerator(0) 方 法 后 ， 编 译 圳 还 会 继续 给 出 缺失 其 他 方 
法 和 属性 的 警告 ， 如 图 3-9 所 示 。 


Description 


1 foreach requires that the return type void of 
q typ 
‘Thelnterface.Duck.GetEnumerator()' must have a suitable 
public MoveNext method and public Current property 


图 3-9 GetEnumerator 方 法 必须 符合 一 个 隐 式 的 契约 
代码 清单 3-25 展 示 了 这 些 要 配合 GetEnumerator 方 法 实现 的 属性 。 
代码 清单 3-25 ”完成 DuckEnumerator 类 的 隐 式 接口 


public class DuckEnumerator 


{ 


int i = 0; 


public bool MoveNext() 
{ 
return i++ < 10; 


} 


public int Current 


{ 
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get 
{ 
return 1; 


} 


} 


至 此 ,你 已 经 成 功 地 为 foreach 循 环 实现 了 所 需 的 隐 式 接口 。 这 就 是 已 经 存在 的 鸭子 类 型 的 应 
用 ， 千 真 万 确 啊 ! 


3.3.2 ”混合 类 型 


混合 类 型 ( mixin ) 是 一 个 从 鸭子 类 型 扩展 出 来 的 概念 。 该 类 包含 了 多 个 其 他 类 的 实现 ， 但 
它 并 未 继承 这 些 类 的 实现 。 因为 如 前 面 所 讲 ，C# 并 不 支持 继承 多 重 实现 , 所 以 混合 类 型 采用 了 其 
他 技术 方式 。 

可 以 使 用 扩展 方法 来 实现 混合 类 型 , 这 种 方案 虽然 小 巧 但 也 有 局 限 性 。 扩展 方 法 可 以 给 已 经 
定义 好 的 类 增加 方法 ， 在 有 些 场景 下 很 有 用 。 男 外 一 种 方案 是 使 用 诸如 Re-motion Re-Mix 之 类 的 
第 三 方 库 ， 与 Impromptu Interface 类 似 ， 通 过 在 运行 时 创建 新 类 来 支持 你 指定 的 所 有 接口 ， 看 起 
来 就 像 是 一 个 多 功能 适 配 带 。 

1. 使 用 扩展 方法 

从 版 本 3.5 开 始 ，.NET Framewo 水 就 提供 了 扩展 方法 的 特性 。 它 能 够 为 已 经 存在 的 类 添加 新 
功能 ， 既 不 需要 访问 原 有 类 源 代码 ， 也 不 需要 为 该 类 标记 partial。 代 码 清单 3-26 展 示 了 给 已 知 
接口 增加 两 个 新 方法 的 示例 。 


代码 清单 3-26 扩展 方法 可 以 增强 已 有 接口 


public interface ITargetInterface 














{ 
void DoSomethingQO; 
} 
Ge 
public static class MixinExtensions 
{ 
public static void FirstExtensionMethod(this ITargetInterface target) 
{ 
Console.WwWriteLine("The first extension method was called."); 
} 
public static void SecondExtensionMethod(this ITargetInterface target) 
{ 
Console.WriteLine("The second extension method was called."); 
} 
} 


在 引用 了 MixinExtensions 类 后 , 客户 端 代码 访问 一 个 ITargetInterface 实 例 时 也 会 看 到 
这 两 个 扩展 的 方法 。 扩 展 方法 的 数目 没有 限制 ,也 可 以 通过 多 个 静态 类 为 同一 接口 添加 扩展 方法 。 
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代码 清单 3-27 展 示 了 ITargetInterface 的 另外 两 个 带 有 参数 的 扩展 方法 。 
代码 清单 3-27 扩展 方法 也 可 以 带 有 参数 


public static class MoreMixinExtensions 





{ 
public static void FurtherExtensionMethodA(this ITargetInterface target, int 
extraParameter) 
{ 
Console.WritelLine("Further extension method A was called with argument {0}", 
extraParameter); 
} 
public static void FurtherExtensionMethodB(this ITargetInterface target, string 
stringParameter) 
{ 
Console.WritelLine("Further extension method B was called with argument {0}", 
stringParameter); 
} 
} 








如 代码 清单 3-28 所 示 ， 这 些 扩展 方法 与 接口 的 原 有 方法 一 样 可 以 被 任何 客户 端 调 用 。 
代码 清单 3-28 客户 病 可 以 访问 接口 的 扩展 方法 


public class MixinClient 


{ 
public MixinClient(CITargetInterface target) 
{ 
this.target = target; 
} 
public void RunQO) 
{ 
target.DoSomething(); 
target. FirstEXxtensionMethod () ; 
target .SecondExtensionMethod() ; 
target .FurtherExtensionMethodA(30) ; 
target.FurtherExtensionMethodB("Hello!"); 
} 
private readonly ITargetInterface target; 
} 








使 用 扩展 方法 构造 混合 类 型 也 有 一 些 明 显 的 局 限 。 第 一 个 是 有 关 可 测 性 的 局 限 ， 如 第 4 章 会 
讲解 到 的 ， 静 态 类 很 难 被 模拟 和 蔡 换 ， 所 以 会 导致 调用 这 些 扩展 方法 的 客户 端 代 码 较 难 测 试 。 

更 糟糕 的 是 ， 静 态 类 的 扩展 方法 无 法 使 用 目标 类 实例 的 任何 状态 。 当 然 ， 通 过 使 用 静态 字典 
存储 对 象 的 状态 值 也 可 以 变通 取得 实例 状态 ， 但 是 毕竟 不 完美 ， 会 融 来 其 他 问题 。 

另外 一 点 值得 注意 的 是 , 所 有 扩展 方法 都 要 指向 相同 的 接口 , 所 有 运行 实例 都 必需 实现 该 接 
口 。 然 而 ， 真 正 的 混合 类 型 是 一 个 聚合 适 配 硕 ， 它 应 该 能 够 同时 实现 多 个 不 同 接口 。 
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2. 使 用 Re-motion Re-mix 

实现 混合 类 型 的 另外 一 种 方式 就 是 使 用 诸如 Re-motion Re-mix 之 类 的 第 三 方 库 。 在 创建 特定 
目标 类 时 , Re-motion Re-mix 能 够 通过 运行 时 配置 来 指定 要 组 合 的 类 。 与 Impromptu Interface 一 样 ， 
Re-motion Re-mix 会 创建 一 个 满足 混合 类 型 要 求 的 所 有 接口 的 新 类 ， 而 当 调 用 接口 方法 时 ， 这 个 
新 类 的 实例 会 将 调用 委托 给 混合 类 型 的 实例 。 代 码 清单 3-29 展 示 了 多 个 接口 及 其 实现 。 


代码 清单 3-29 ”多 个 独立 的 接口 组 合成 一 个 混合 类 型 


public interface ITargetInterface 














{ 
void DoSomething (D) ; 
} 
7 
public class TargetImplementation : ITargetInterface 
{ 
public void Dosomething () 
{ 
Console.WriteLine("ITargetInterface.DoSomethingO "); 
} 
} 
0 
public interface IMixinInterfaceA 
{ 
void MethodA(); 
} 
A 
public class MixinImplementationA : IMixinInterfaceA 
{ 
public void MethodAQO 
{ 
Console.WriteLine("IMixinInterfaceA.MethodA()"); 
} 
} 
人 
public interface IMixinInterfaceB 
{ 
void MethodB(int parameter); 
} 
jE 
public class MixinImplementationB : IMixinInterfaceB 
{ 
public void MethodB(int parameter) 
{ 
Console.WriteLine("IMixinInterfaceB.MethodB({0})", parameter); 
} 
} 
/A 
public interface IMixinInterfaceC 
{ 
void MethodC(string parameter); 
} 


J i 
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public class MixinImplementationC : IMixinInterfaceC 


{ 
public void MethodC(string parameter) 
{ 
Console.WriteLine("IMixinInterfaceC.MethodC(\"{0}\")", parameter); 
} 
} 


注意 ， 这 里 并 没有 一 个 单独 的 类 同时 实现 了 所 有 接口 ， 而 是 通过 配置 Re-mix 来 请 求 一 个 
TargetImplemation 类 的 实例 ， 该 实例 同时 组 合 了 所 有 接口 和 实现 。 代 码 清 单 3-30 是 一 个 配置 
示例 。 


代码 示例 3-30 ”使 用 Re-mix 构 造 TargetImplementation 类 的 实例 


var config = MixinConfiguration.BuildFromActive() 
.ForClass<TargetImp lementation>() 
.AddMi xin<MixinImplementationA>() 
.AddMi xin<MixinImplementationB>() 
.AddMi xin<MixinImplementationC>() 
.Bui1dConfiguration() ; 





MixinConfiguration.SetActiveConfiguration(config); 





但 是 ， 你 无 法 简单 地 通过 new 创 建 一 个 TargetImplementation 来 获得 混合 类 型 实例 ， 而 是 必 
须 通 过 Re-mix 来 完成 。 代码 清单 3-31 展 示 了 使 用 Re-mix 创 建 实例 的 代码 , 幸运 的 是 , 代码 还 算 小 巧 。 





代码 清单 3-31 由 Re-mix 人 负责 创建 混合 类 型 


ITargetInterface target = ObjectFactory.Create<TargetImplementation>(CParamList.Emptyy) 





不 幸 的 是 ， 你 不 知道 ( 也 无 法 知道 ) 0bjectFactroy.Create 方 法 返回 实例 的 确切 类 型 ， 只 
知道 它 是 子 类 (subclass ) TargetImplementation 的 一 个 实例 ， 这 就 是 Re-mix 的 局 限 之 一 。 这 
个 局 限 会 给 使 用 混合 类 型 的 客户 端 代 码 市 来 负面 影响 , 因为 客户 端 代码 在 编译 时 唯一 能 确定 的 是 
TargetImplementation 类 实现 了 ITargetInterface 接 口 ,因此 它 不 得 不 通过 使 用 is 来 探测 类 ， 
然后 使 用 as 将 混合 类 型 实例 转换 为 想 要 的 接口 。 代 码 清单 3-32 展 示 了 这 个 问题 。 


代码 清单 3-32 ”类 探测 不 值得 提倡 ， 但 要 使 用 混合 类 型 就 必须 要 使 用 它 


public class MixinClient 








{ 
public MixinClient(ITargetInterface target) 
{ 
this.target = target; 
} 


public void RunQO 


{ 
target.DoSomething(); 
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var targetAsMixinA = target as IMixinInterfaceA; 
if(targetAsMixinA != null) 
{ 


targetAsMixinA.MethodA(); 
} 


var targetAsMixinB = target as IMixinInterfaceB; 
if(targetAsMixinB != null) 
{ 
targetAsMixinB.MethodB(30); 
} 


var targetAsMixinC = target as IMixinInterfaceC; 
if(targetAsMixinC != null) 
{ 
targetAsMixinC.MethodC("Hello!"); 
} 


private readonly ITargetInterface target; 











要 使 用 混合 类 型 ， 类 探测 最 好 是 已 经 存在 的 或 者 必需 的 。 很 多 库 和 平台 也 都 在 这 样 做 。 比 如 
Prism ( Windows Presentation Foundation/Model-View-ViewModel 库 ) 就 使 用 了 类 探测 ， 使 用 Prism 
的 客户 端 类 所 需要 的 功能 会 被 分 割 为 多 个 独立 的 不 同 实 现 ， 然 后 再 重新 组 合 为 一 个 混合 类 型 。 


3.3.3 流 


接口 


流 接 口 (fluent interface ) 会 有 一 个 或 多 个 方法 返回 自身 实例 。 这 样 ， 客户 端 代码 就 可 以 将 所 
有 返回 实例 的 方法 的 调用 链接 起 来 ， 如 代码 清单 3-33 所 示 。 


代码 清单 3-33 ” 流 接口 支持 方法 链 的 调用 方式 


public class FluentClient 


{ 


public FluentClient(CIFluentInterface fluent) 


{ 


} 


this.fluent = fluent; 


public void RunQO 


{ 


// without using fluency 
fluent.DoSomething(); 
fluent.DoSomethingElseQ); 
fluent .DoSomethingElse() ; 
fluent.DoSomething(); 
fluent.ThisMethodIsNotFluentO; 


// using fluency 
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fluent.DoSomething() 
.DoSomethingElse() 
.DoSomethingElse() 
.DoSomething() 
.ThisMethodIsNotF1uent() ; 
} 


private readonly IFluentInterface fluent; 





这 种 方法 链 的 调用 方式 可 以 改善 代码 的 可 读 性 , 因为 它 可 以 避免 重复 引用 接口 实例 。 这 种 方 
式 也 变 得 越 来 越 流 行 ， 用 来 实现 配置 或 有 限 状 态 机 。 第 8 草 中 会 有 更 多 相关 讲解 。 

实现 流 接口 也 很 简单 ， 只 需要 每 个 方法 都 返回 类 实例 本 喘 。 因 为 类 是 接口 的 实现 , 所 以 返回 
的 是 接口 实例 ， 这 样 就 保证 隐藏 了 实现 细节 。 代 码 清单 3-34 展 示 了 IF1uentInterface 接 口 的 定 
义 以 及 实现 。 


代码 清单 3-34 ”实现 一 个 简单 的 流 接 口 很 容易 


public interface IFluentInterface 














{ 
IFluentInterface DoSomethingQO; 
IFluentInterface DoSomethingElseQO); 
void ThisMethodIsNotF1luent() ; 
} 
/et 
public class FluentImplementation : IFluentInterface 
{ 
public IFluentInterface DoSomethingQ) 
{ 
return this; 
} 
public IFluentInterface DoSomethingElse() 
{ 
return this; 
} 
public void ThisMethodIsNotFluent() 
{ 
} 
} 





请 注意 ， 上 面 示例 中 有 个 接口 方法 不 是 流 方法 ， 因 为 它 的 返回 类 是 void。 返 回 非 接口 类 数 
据 的 方法 都 不 是 流 方法 ， 非 流 方法 会 导致 客户 闪 代 码 中 方法 链 方 式 的 调用 中 靳 。 
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3.4 ” 忆 结 








本 鞋 告诉 你 接口 是 什么 以 及 接口 为 什么 对 编写 自 适 应 代码 如 此 重要 。 接口 具有 的 多 态 能 力 文 
持 在 实现 类 中 隐藏 变化 ， 这 也 是 设计 模式 的 基础 。 此 外 接口 本 号 实 际 上 什么 都 不 做 。 

切记 ,没有 相应 的 实现 , 接口 本 身 也 上 无 用 处 。 但 是 如 果 没 有 接口 定义 ,实现 类 以 及 它们 的 
各 种 依赖 关系 将 会 在 代码 中 到 处 蔓延 , 从 而 严重 影响 代码 的 维护 和 扩展 。 展 好 组 织 和 部 署 的 接口 
就 像 一 道 防火 墙 ， 能 把 整洁 有 序 的 客户 端 代码 和 复杂 烦 乱 的 服务 代码 完整 地 隔离 开 来 。 

接口 也 有 其 他 一 些 特殊 特性 ， 比 如 鸭子 类 型 和 混合 类 型 。 它 们 的 使 用 频率 不 高 ,但 是 在 合适 
的 场合 中 ， 它 们 能 够 简化 代码 结构 ， 同 时 能 为 代码 的 上 自 适 应 能 力 提 供 一 个 额外 的 维度 。 

本 前 所 讲解 的 内 容 为 本 书后 续 的 各 种 接口 应 用 奠定 了 坚实 的 基础 。 























单元 测试 和 重 构 





完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 定义 单元 测试 和 重 构 ， 并 且 能 够 解释 为 什么 二 者 都 是 很 有 用 的 软件 开发 技术 。 

口 理解 单元 测试 与 重 构 之 间 的 内 在 联系 。 

口 以 测试 先行 的 方式 编写 代码 ， 只 有 在 测试 需要 时 才 集 中 实现 。 

口 重 构 产 品 代 码 来 改善 整体 设计 。 

口 识别 定义 过 度 的 单元 测试 并 且 重 构 它 们 。 

本 章 会 集中 讲解 单元 测试 和 重 构 这 两 个 不 同 但 都 是 最 佳 编程 实践 的 软件 开发 技术 。 

单元 测试 (unit testing ) 是 指 编写 代码 来 专门 测试 其 他 代码 。 单 元 测试 本 身 的 源 代 码 是 可 以 
编译 和 执行 的 。 每 个 单元 测试 项 在 运行 后 ， 都 会 用 简单 的 布尔 值 来 报告 成 功 与 否 , 通常 还 会 带 有 
绿色 或 红色 的 图 像 指示 。 如 果 产 品 代码 通过 了 所 有 单元 测试 , 那么 可 以 认为 它 基 本 上 是 可 以 工作 
的 。 只 要 有 一 个 测试 项 运行 失败 了 《即使 是 在 成 百 上 千 的 测试 中 )， 就 可 以 肯定 整个 产品 代码 是 
无 法 正常 工作 的 。 

重 构 ( refactoring ) 是 一 种 逐渐 改进 现 有 代码 设计 的 过 程 。 这 个 过 程 类 似 于 要 编写 很 多 次 草 
稿 代 码 ， 就 像 是 我 为 了 这 本 书 也 写 了 很 多 草稿 一 样 。 鉴 于 我 们 这 些 开发 人 员 很 少 能 一 次 就 把 事 
情 做 好 的 现状 ， 重 构 能 够 让 我 们 先 从 最 简单 的 部 分 开始 ， 然 后 逐步 改进 ， 最 终 实现 一 个 比较 好 
的 方案 。 

单元 测试 能 让 随时 随地 重 构 成 为 可 能 。 当 你 尽早 开始 单元 测试 时 ( 也 就 是 说 , 在 编写 任何 产 
品 代码 前 )， 就 创建 了 一 个 安全 网 ， 它 能 捕获 所 有 由 后 期 重 构 引起 的 错误 。 如 果 一 个 本 来 成 功 的 
单元 测试 变 成 失败 状态 , 你 就 知道 最 近 对 代码 的 改动 带 来 了 问题 。 这 个 边 写 代码 边 重 构 改 进 设计 
的 方式 是 一 个 螺旋 上 升 的 过 程 ， 这 个 过 程 能 够 在 逐步 实现 新 特性 的 同时 改善 代码 质量 。 


4.1 单元 测试 


一 定 程 度 上 , 单元 测试 应 当 是 每 个 编程 人 员 日 常 的 必 做 功课 之 一 。 一 些 开 发 人 员 眼 中 的 理想 
状态 是 整个 产品 代码 ( 构成 软件 产品 的 基本 代码 ) 都 是 由 测试 驱动 产生 的 ， 编 写 的 所 有 测试 都 用 
来 验证 应 用 程序 的 行为 。 本 章 后 面 会 讲解 如 何 通过 测试 驱动 开发 来 达到 这 个 目的 。 但 也 要 切记 ， 
我 们 的 目标 是 要 务实 而 不 是 成 为 纯粹 主义 者 , 在 一 个 时 间 点 上 , 接受 一 些 可 以 后 期 解决 的 技术 债 
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务 并 交付 一 些 成 果 总 比 为 了 编写 更 多 单元 测试 而 迟 迟 无 法 交付 任何 成 果 要 好 得 多 。 当 然 , 每 个 项 
目 对 时 效 性 和 完成 度 的 要 求 也 有 所 不 同 。 

应 用 一 些 已 知 的 单元 测试 模式 和 原则 能 够 保证 有 好 的 结果 。 这 些 模式 和 原则 并 不 是 新 鲜 事 
物 , 它们 已 经 被 普遍 使 用 和 验证 过 了 。 它们 最 关注 的 是 如 何 布 置 和 命名 单元 测试 ,特别 是 如 何 保 
证 代码 的 可 测试 性 。 如 果 这 些 关 注 点 被 忽略 了 ， 源 代码 就 会 与 单元 测试 脱节 ， 失 败 的 测试 也 变 得 
无 关 紧 要 ， 由 单元 测试 建立 起 来 的 安全 网 最 终 也 会 变 得 凋零 破 停 。 


4.1.1 布置 、 动 作 和 断言 


每 个 单元 测试 都 包括 以 下 三 个 部 分 。 

口 布置 测试 前 置 条 件 。 

口 执行 要 测试 的 动作 。 

口 断言 所 期 望 的 行为 。 

这 三 部 分 来 源 于 布置 、 动 作 和 断言 (Arrange, Act, Assert，AAA ) 模式 。 你 应 该 按照 这 个 模 
式 编写 测试 ， 这 样 其 他 人 也 能 够 理解 它们 。 

















注意 ， 有 些 读 者 可 能 更 熟悉 假设 、 当 :……: 时 、 应 该 会 (Given, When, Then，GWT ) 模式 。 
它 与 AAA 很 相似 ， 只 是 描述 测试 的 方式 不 同 : 假设 某 些 前 置 条 件 已 经 得 到 满足 ， 当 执行 测试 
的 目标 动作 时 ， 应 该 会 发 生 预 期 的 某 些 行为 。 


1. 布置 测试 前 置 条 件 

当 要 测试 目标 动作 时 ,你 必须 先 搭 建 测试 场景 的 上 下 文 。 对 于 一 些 测试 而 言 ， 你 只 需要 简单 
地 构造 测试 目标 系统 (System Under Test，SUT ) 的 实例 。 这 种 情况 下 ， 测 试 目标 系统 就 是 你 要 
测试 的 类 型 ， 如 果 类 没有 有 效 的 实例 ， 将 无 法 测试 类 的 任何 方法 。 

代码 清单 4-1 是 个 测试 的 布置 代码 示例 , 其 中 的 Account 类 定义 了 客户 的 账户 和 交易 。 这 里 我 
使 用 的 是 Visual Studio 内 置 支持 的 MSTest。 后 面 还 会 在 这 个 示例 的 基础 上 继续 增加 该 测试 的 动作 
和 汤 言 部 分 。 测 试 方法 的 名 称 是 AddingTransactionChangesBalance, 人 简明 地 描述 了 该 测试 的 
目的 : 确保 用 户 账户 上 新 发 生 的 交易 总 是 会 改变 账户 账目 以 包括 新 发 生 的 交易 金额 。 


代码 清单 4-1 布置 单元 测试 的 第 一 步 通常 都 是 构造 测试 目标 系统 


[TestClass] 
public class AccountTest 


{ 











[TestMethod] 

public void AddingTransactionChangesBalance() 
// Arrange 
var account = new Account() ; 
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这 个 示例 中 的 布置 过 程 很 简单 。 整 个 测试 的 前 置 条 件 就 是 一 个 Account 类 的 实例 。 你 只 需要 
在 测试 方法 中 直接 调用 new 运 算 符 创建 一 个 实例 。 接 下 来 你 可 以 继续 AAA 模式 的 下 一 步 了 。 

2. 执行 可 测试 的 动作 

现在 ,能够 执行 动作 的 测试 目标 系统 已 经 准备 好 了 ,你 可 以 执行 要 测试 的 方法 了 。 每 个 测试 
的 动作 阶段 只 应 该 与 测试 目标 系统 交互 一 次 , 比如 只 调用 一 个 方法 ,或 只 使 用 一 次 属性 的 存 或 取 。 
这 样 做 的 好 处 是 ， 测 试 的 执行 路 径 足 够 简单 清晰 ， 编 写 和 理解 它 也 会 很 容易 。 

代码 清单 4-2 展 示 了 测试 的 动作 部 分 。 其 中 调用 了 account .AddTransaction 方 法 ， 符 合 测 
试 方法 名 称 的 含义 。 


代码 清单 4-2 ”每 个 动作 执行 部 分 应 该 与 测试 目标 系统 只 有 一 次 交互 


[TestClass] 
public class AccountTest 


{ 











[TestMethodj 
public void AddingTransactionChangesBalance() 
{ 

// Arrange 

var account = new AccountQ); 


/A Act 
account.AddTransaction (200m); 


} 


在 该 示例 中 ，AddTransaction 方 法 得 到 了 一 个 传人 参数 值 ， 它 就 是 要 给 账户 增加 的 交易 资 
金额 度 。 这 里 使 用 小 数值 意味 着 它 有 很 高 的 精度 , 但 是 并 没有 指明 货币 单位 。 为 了 简单 起 见 , 我 
们 暂时 假设 账户 和 交易 都 以 美元 为 单位 。 

到 此 ， 这 个 测试 已 经 包括 了 布置 和 动作 部 分 ， 接 下 来 你 可 以 为 它 添加 最 后 一 个 部 分 了 。 

3. 断言 所 期 望 的 行为 

紧 跟 上 述 两 个 步骤 后 是 这 个 示例 以 及 其 他 所 有 单元 测试 的 关键 点 : 断言 。 你 能 看 到 的 绿色 成 
功 或 红色 失败 图 形 标识 就 是 断言 的 结果 。 所 做 的 断言 也 与 方法 的 名 称 含义 相符 ， 在 这 个 示例 中 ， 
名 称 的 含义 就 是 账户 的 账目 被 新 的 交易 改变 了 。 此 处 , 断言 要 做 的 就 是 对 实际 值 和 期 望 值 进行 对 
比 。 根 据 测 试 目标 系统 的 状态 值 进行 断言 是 基于 状态 测试 的 一 种 常见 形式 ， 它 会 要 求实 际 值 和 期 
望 值 完全 相同 。 

从 Account 类 的 Balance 属 性 中 可 以 获得 实际 值 ， 期 望 值 则 是 由 你 定义 的 一 个 销量 。 这 就 意 
味 着 你 必须 提前 知道 期 望 值 ， 这 也 是 编写 测试 的 关键 点 之 一 。 你 需要 提前 知道 期 望 值 ， 而 不 是 通 
过 代码 推导 出 来 。 上 面 示 例 当 中 ,得 出 这 个 期 望 值 很 容易 。 假 设 是 一 个 新 的 账户 ,那么 它 的 账目 
一 定 是 0， 如 果 你 给 账户 增加 200 美 元 ， 那 么 期 望 值 应 该 是 多 少 呢 ? 

$0.00 + $200.00 = $200.00 
因此 ， 你 可 以 编写 断言 部 分 来 完成 上 面 示例 的 AAA 测 试 ， 如 代码 清单 4-3 所 示 。 
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代码 清单 4-3 ”添加 了 对 期 望 行为 的 断言 的 单元 测试 


[TestClass] 
public class AccountTest 
{ 
[TestMethod] 
public void AddingTransactionChangesBalanceQ) 
{ 
// Arrange 
var account = new Account(); 


// Act 
account.AddTransaction(200m); 


// Assert 
Assert.AreEqual(200m，account.Balance) ; 


} 





到 这 里 ， 这 个 示例 测试 已 经 为 运行 作 好 了 准备 。 通 过 运行 测试 ,你 可 以 验证 测试 目标 系统 是 
否 像 期 望 的 那样 起 作用 。 

4. 运行 测试 

编写 好 单元 测试 后 , 你 就 可 以 使 用 一 个 单元 测试 运行 絮 来 运行 它们 。 包含 单元 测试 的 测试 工 
程 的 输出 是 无 法 直接 执行 的 程序 集 , 这 就 意味 着 测试 工程 无 法 执行 本 身 而 必须 作为 一 个 单元 测试 
运行 器 的 输入 。Microsoft Visual Studio 内 置 有 测试 运行 需 来 文 持 符合 MSTest 定 义 的 单元 测试 。 如 
果 是 其 他 类 型 的 单元 测试 ， 可 能 需要 给 Visual Studio 安 装 测试 运行 器 插件 。 

在 Visual Studio 当 中 ， 你 可 以 使 用 Tesf>Run 沫 单项 下 的 选项 来 运行 MSTest 单 元 测试 。 这 里 你 
先 选 择 所 有 测试 选项 ， 它 对 应 的 快捷 组 合 键 是 CtrlI+R+A。 图 4-1 展 示 了 运行 符合 AAA 模式 的 测试 
后 的 输出 。 











Test Explorer 中 XxX 
[EE ~ | Search Pp- 
Run All | Run... v | Playlist:AllTests ~ 
4 Failed Tests (1) AddingTransactionChangesBalance 
@ AddingTransactionChangesBalance 36ms Source: AccountTestcs line 12 


四 Test Failed - AddingTransactionChangesBalance 
Message: Assert.AreEqual failed. Expected:<200>. Actual:<0>. 
Elapsed time: 36 ms 
4 StackTrace: 
AccountTestAddingTransactionChangesBalancel0 





图 4-1 使 用 Visual Studio 内 置 的 MSTest 单 元 测试 运行 器 运行 单元 测试 


当 你 在 左 侧 列表 中 选 定 一 个 单元 测试 时 , 右 侧 会 显示 出 该 测试 的 很 多 详细 信息 。 示例 中 可 以 
看 到 ， 该 单元 测试 只 耗费 了 短 短 的 三 十 六 毫 秒 ,这 恰恰 就 是 编写 单元 测试 的 一 大 优势 : 即使 运行 
成 百 上 千 的 单元 测试 也 不 会 耗费 多 少时 间 ， 相 比 之 下 ， 手 动 测试 则 会 耗费 大 量 的 时 间 。 

尽管 如 此 ， 示 例 中 的 执行 结果 是 失败 的 ， 因 为 期 望 值 200 并 不 等 于 实际 值 。 断 言语 句 中 的 
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account.Balance 属 性 的 值 是 0。 

这 是 因为 Account 类 还 缺少 很 多 细 市 实现 。 代码 清单 4-4 展 示 了 到 此 所 需 的 Account 类 的 最 小 
实现 。 
代码 清单 4-4 在 单元 测试 前 ， 测 试 目标 系统 并 不 需要 具体 实现 


public class Account 


{ 
public void AddTransaction(decimal amount) 
{ 
} 
public decimal Balance 
{ 
get ， 
private set; 
} 
} 


可 以 看 得 出 来 ，AddTransaction 方 法 什么 都 没有 做 ，Balance 属 性 也 只 是 一 个 带 有 私有 设 
置 器 的 默认 自动 属性 。 为 了 让 测试 通过 , 你 需要 为 Account 类 增加 实现 以 达到 你 在 断言 中 的 期 望 。 


4.1.2 ”测试 驱动 开发 


为 了 实现 某 个 单元 测试 ， 你 无 需 完整 实 现 整个 测试 目标 系统 。 在 测试 驱动 开发 (Test-Driven 
Development，TDD ) 方法 中 ， 推 荐 在 编写 单元 测试 前 不 要 有 可 以 工作 的 测试 目标 系统 。 在 使 用 
测试 驱动 开发 方法 时 ， 你 需要 先 编写 测试 代码 ， 然 后 才 编 写 产 品 代码 。 产 品 代 码 中 的 每 个 类 的 
每 个 方法 都 要 经 过 一 次 失败 的 测试 ， 这 次 失败 的 唯一 原因 就 是 产品 的 具体 实现 代码 还 不 存在 。 
断言 要 求 的 测试 驱动 开发 以 某 种 方式 执行 动作 ， 但 是 这 种 动作 还 没有 实现 ， 因 此 测试 失败 了 。 
在 满足 测试 需求 的 前 提 下 以 尽 可 能 简单 的 方式 编写 产品 的 实现 代码 后 ， 就 能 看 到 该 测试 的 绿色 
通过 图 标 了 。 

1. 失败 、 成 功 、 重 构 

到 此 ,我 们 只 介绍 了 AddingTransactionChangesBalance 单 元 测试 在 失败 、 成 功 、 重 构 (red， 
green, refactor ) 三 步 曲 流程 中 的 第 一 步 。 

(1) 针对 测试 目标 系统 的 期 望 行为 编写 一 个 失败 的 测试 。 

(2) 给 测试 目标 系统 添加 恰当 的 实现 来 让 新 加 入 的 测试 通过 , 且 不 影响 所 有 已 经 存在 的 测试 。 

(3) 看 看 测试 目标 系统 的 设计 或 代码 质量 是 否 有 改进 的 机 会 ， 如 果 有 ， 立 刻 进行 重 构 。 

第 一 步 创 建 的 失败 测试 会 在 测试 运行 器 上 显示 一 个 红色 的 失败 图 标 ,第 二 步 加 入 实现 后 让 测 
试 从 失败 状态 转变 为 成 功 状态 ， 图 标 也 会 相应 地 变 成 绿色 。 到 第 三 步 时 ， 就 可 以 逐步 递增 地 改善 
代码 ， 同 时 无 需 担 心 变更 会 破坏 现 有 功能 。 

要 将 测试 状态 从 红 变 为 绿 (从 失败 转换 为 成 功 )， 需 要 按照 流程 定义 的 第 二 步 动作 : 给 测试 
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目标 系统 添加 恰当 的 实现 来 让 测试 通过 。 因 为 上 面 示例 中 只 有 一 个 测试 , 所 以 你 不 需要 担心 影响 
到 其 他 已 有 的 成 功 测试 。 

测试 所 断言 的 行为 是 , 在 一 个 新 账户 上 进行 交易 后 ,账户 的 余额 应 该 从 0 变 成 了 200。 代码 清 
单 4-5 展 示 了 为 了 让 测试 通过 所 能 作 的 最 小 改动 。 


代码 清单 4-5 ”总 是 引入 最 小 实现 来 让 失败 的 测试 变 得 成 功 


public class Account 


{ 
public Account () 
{ 
Balance = 200m; 
} 
public void AddTransaction(decimal amount) 
{ 
} 
public decimal Balance 
{ 
get; 
private set; 
} 
} 





示例 中 加 粗 显 示 了 所 作 的 最 小 代码 改动 。 为 了 让 测试 由 红 变 绿 ， 直 接 在 Account 类 的 默认 构 
造 函 数 中 将 Balance 属 性 初始 化 为 200m。 图 4-2 展 示 了 Visual Sutido 测 试 运行 器 重新 运行 失败 测试 
后 的 截屏 ， 它 证 明 最 小 的 改动 起 作用 了 ， 测 试 现在 成 功 了 。 





[EE ~ | Search A- 
Run All | Run.. ~ | Playlist:AllTests ~ 
4 Passed Tests (1) AddingTransactionChangesBalance 

© AddingTransactionChangesBalance 15ms Source: AccountTest.cs line 12 


人 加 Test Passed - AddingTransactionChangesBalance 
Elapsed time: 15 ms 





图 4-2 ”现在 ， 测 试 的 确 成 功 了 ， 但 是 它 真 的 正确 吗 


在 你 信心 满 满 地 准备 开始 重 构 前 , 应 该 清楚 目 己 在 第 二 步 所 做 的 实现 是 否 正 确 。 你 可 以 通过 
增加 另外 一 个 单元 测试 来 从 另外 一 个 期 望 角度 来 证 明示 例 中 的 实现 是 不 正确 的 。 

要 增加 的 测试 定义 了 新 创建 账户 对 象 上 的 期 望 余额 。 回 顾 上 面 的 示例 ， 在 发 生 了 一 个 200 美 
元 的 交易 后 ，Balance 属 性 的 期 望 值 也 是 200 美 元 ， 这 是 基于 一 个 假设 : 新 创建 账号 的 余额 是 0 美 
元 。 这 也 是 一 个 期 望 的 行为 , 所 以 你 应 该 为 此 编写 一 个 新 的 测试 来 断言 实现 代码 是 否 正 确 。 代 码 
清单 4-6 展 示 了 在 新 的 单元 测试 上 应 用 AAA 模 式 后 的 代码 。 
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代码 清单 4-6 下面 示例 中 忽略 了 布置 部 分 的 代码 


[TestMethod] 
public void AccountsHaveAnOpeningBalanceOfZero() 


{ 
// Arrange 


// Act 
var account = new Account() ; 


// Assert 
Assert.AreEqual(O0m, account.Balance); 


} 





首先 , 你 可 以 看 到 这 个 新 测试 的 名 称 也 恰当 地 描述 了 断言 所 期 望 的 行为 。 其 次 ,你 会 看 到 这 4 
个 单元 测试 示例 中 , 布 园 部 分 代码 是 空 的 , 这 说 明了 AAA 模式 中 的 布置 部 分 是 可 选 的 。 这 里 要 测 
试 目 标 系统 的 行为 就 是 默认 构造 函数 ， 它 就 是 该 测试 中 动作 部 分 与 测试 目标 系统 唯一 交互 的 代 
码 。 最 后 的 断言 部 分 要 求实 现 第 一 个 示例 的 假设 ; 新 创建 账户 的 账户 余额 应 该 是 0 美元 。 








尽管 前 一 个 单元 测试 依然 是 成 功 的 , 但 是 这 个 测试 的 运行 结果 是 失败 的 , 这 就 证 明了 为 了 让 
第 一 个 测试 通过 而 添加 的 最 小 实现 是 错误 的 。 图 4-3 展 示 了 MSTest 运 行 带 的 输出 。 
[EE ~ | Search A- 
Run All | Run... ~ | Playlist:AllTests ~ 
4 es Tests (1) AccountsHaveAnOpeningBalanceOfZero 
中 ye nOpeningBalanceOfZero 2 Source: AccountTest.cs line 12 


四 Test Failed - AccountsHaveAnOpeningBalanceOfZero 


@ AddingTransactionChangesBalance <1ms 


Message: Assert.AreEqual failed. Expected:<0>. Actual:<200>. 
Elapsed time: 23 ms 
4 StackTrace: 
AccountTest.AccountsHaveAnOpeningBalanceOfZero() 


图 4-3 ”为 第 一 个 单元 测试 添加 的 实现 导致 了 第 二 个 单元 测试 的 失败 


此 时 , 如果 你 删除 了 默认 构造 函数 中 的 实现 代码 ,第 二 个 验证 开户 账户 余额 ( opening balance ) 
的 单元 测试 会 由 红 变 绿 ， 但 是 同时 第 一 个 验证 交易 改变 账户 余额 (adding transaction ) 的 测试 则 
会 再 次 变 回 失败 状态 。 这 就 证 明了 , 更 新 后 的 实现 对 Account 类 的 开户 账户 余额 的 测试 是 正确 的 ， 
但 对 交易 改变 账户 余额 的 测试 来 说 是 错误 的 。 

增加 新 测试 的 另外 一 个 限制 就 是 需要 改变 测试 目标 系统 的 现 有 实现 。 每 个 新 的 测试 都 囊 有 自 
己 期 望 的 行为 ， 每 个 新 的 期 望都 要 求 在 已 有 测试 目标 系统 的 内 部 实现 上 做 出 平衡 。 代 码 清单 4-7 
展示 了 一 种 可 能 的 最 简单 实现 ， 它 能 够 保证 以 上 两 个 单元 测试 同时 成 功 。 


代码 清单 4-7 现在 这 个 实现 让 两 个 测试 都 成 功 了 ,但 是 它 真 的 是 正确 的 吗 


public class Account 


{ 














public void AddTransaction(decimal amount) 


{ 
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Balance = 200m; 


} 
public decimal Balance 
{ 
get ， 
private set; 
} 


} 


至 此 ， 新 开 账 户 的 账户 余额 是 0(， 而 且 在 调用 AddTransaction 方 法 后 账户 余额 会 变 为 200m。 
尽管 两 个 测试 都 成 功 了 , 但 是 直觉 告诉 你 这 个 实现 一 定 是 错误 的 。 优 先 编写 最 简单 的 实现 (而 不 
是 直接 实现 明显 正确 的 方案 ) 的 关键 点 是 根据 你 的 直觉 设计 断言 。 你 能 编写 出 另外 一 个 失败 的 单 
元 测试 来 证 明 已 有 的 实现 是 错误 的 吗 ? 代码 清单 4-8 展 示 了 一 个 这 样 的 示例 。 


代码 清单 4-8 ”这 个 单元 测试 与 第 一 个 单元 测试 的 唯一 区 别 是 不 一 样 的 账户 余额 期 望 值 


[TestMethod] 
public void Addingl00TransactionChangesBalance() 
{ 











// Arrange 
var account = new Account() ; 


// Act 
account.AddTransaction(100m); 


// Assert 
Assert.AreEqual(100m, account.Balance); 


} 











这 个 测试 方法 所 做 的 工作 与 第 一 个 单元 测试 一 样 , 都 是 增加 一 个 新 的 交易 , 只 是 交易 值 是 100 
美元 而 不 是 200 美 元 。 尽 管区 别 很 小 , 但 这 个 测试 已 经 足以 证 明 Account 类 的 AddTransaction 方 
法 的 现 有 实现 是 错误 的 。 

按照 单元 测试 三 步 曲 的 期 望 ， 这 个 测试 第 一 次 运行 应 该 是 失败 的 。 如 果 这 时 把 AddTran- 
saction 方 法 的 实现 硬 编 码 为 100m， 这 个 测试 会 成 功 ， 但 是 第 一 个 测试 会 再 次 变 为 失败 的 状态 。 
此 时 ， 你 可 以 实现 一 个 对 现 有 测试 都 正确 的 实现 ， 如 代码 清单 4-9 所 示 。 


代码 清单 4-9 下 面 的 实现 能 保证 三 个 单元 测试 都 成 功 ， 但 是 它 依然 是 错误 的 


public class Account 


{ 
public void AddTransaction(decimal amount) 
{ 
Balance = amount; 
} 


public decimal Balance 
{ 
get ， 
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private set; 


} 


应 用 这 个 实现 后 三 个 单元 测试 都 成 功 了 ， 此 时 似乎 已 经 大 功 告 成 了 。 但 是 还 没有 ! 现 有 的 
AddTransaction 方 法 的 实现 依然 不 能 满足 实际 的 期 望 。 代 码 清 单 4-10 展 示 的 第 四 个 单元 测试 突 
出 了 现 有 实现 的 问题 。 


代码 清单 4-10 ”这 个 单元 测试 最 终 应 该 破解 AddTransaction 方 法 


[TestMethod] 
public void AddingTwoTransactionsCreatesSummationBalance() 
{ 
// Arrange 
var account = new Account(); 
account.AddTransaction(50m); 


// Act 
account.AddTransaction(75m); 


// Assert 
Assert.AreEqual(125m, account.Balance); 


} 


示例 中 的 第 四 个 单元 测试 最 终 让 你 发 现 AddTransaction 方 法 的 绝对 正确 的 实现 (至少 对 所 
有 四 个 单元 测试 而 言 )。 这 种 逐步 重 构 方式 的 重点 在 于 ， 随 着 需求 的 变更 和 新 特性 的 引入 ， 你 需 
要 整理 所 有 类 的 所 有 期 望 以 确保 已 经 存在 的 所 有 单元 测试 都 是 成 功 的 , 而 这 些 已 经 存在 的 单元 测 
试 就 构成 了 一 个 安全 网 。 没 有 这 个 安全 网 ， 虽 然 你 能 随意 改动 代码 ， 小 小 的 改动 看 起 来 影响 范围 
不 大 而 且 你 也 做 了 手动 验证 , 但 是 随后 你 会 发 现 这 些小 小 的 改动 很 可 能 影响 到 了 一 些 表面 看 起 来 
毫 无 瓜 万 的 其 他 功能 。 

你 添加 的 第 四 个 测试 断言 账户 上 的 余额 应 该 是 所 有 交易 的 总 和 。, 而 现 有 的 实现 是 直接 将 账户 
余额 设置 为 最 近 交 易 的 金额 ， 这 种 不 正确 的 实现 一 定 会 导致 新 的 测试 失败 。 代 码 清单 4-11 展 示 的 
AddTransaction 方 法 的 新 实现 能 够 保证 所 有 四 个 单元 测试 都 通过 测试 。 


代码 清单 4-11 目前 为 止 AddTransaction 方 法 的 最 好 实现 


public class Account 


{ 





























public void AddTransaction(decimal amount) 
{ 
Balance += amount; 


} 


public decimal Balance 
{ 

get; 

private set; 
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当 所 有 单元 测试 的 状态 都 由 红 变 绿 时 ， 你 就 可 以 开始 重 构 以 改善 测试 目标 系统 的 现 有 实现 
了 ,只 是 当前 这 个 示例 非常 简单 ,已 经 没有 什么 可 以 优化 的 了 。 对 于 要 给 测试 目标 系统 新 添加 的 
测试 而 言 ， 重 构 这 一 步 非常 关键 。 本 章 后 续 几 节 会 更 详细 地 讲解 这 种 逐步 重 构 的 方式 。 


4.1.3 ”更 复杂 的 测试 


前 面 示例 展示 的 单元 测试 的 目标 类 型 是 一 个 应 用 程序 域 模型 的 一 部 分 , 该 应 用 程序 采用 了 测 
试 先行 的 方式 进行 开发 。 正 如 第 2 章 中 所 讲述 的 ， 这 个 域 模 型 是 处 于 用 户 界 面 层 和 数据 访问 层 之 
间 的 业务 逻辑 层 的 一 个 具体 实现 。 

1. 规格 说 明 

接 下 来 的 一 组 测试 依然 是 基于 Account 类 的 ， 但 是 测试 目标 是 不 同 的 业务 逻辑 层 : 服务 。 对 
于 这 个 假想 的 应 用 程序 而 言 ， 无 论 使 用 何 种 平台 (ASPNET MVC、WPF 或 Windows Form )， 这 
个 服务 都 是 可 重用 的 。 这 就 意味 着 该 服务 不 依赖 任何 平台 ,而 是 基于 Account 类 ， 尺 管 二 者 的 关 








联 是 间接 的 。 图 4-4 展 示 了 构成 该 示例 的 层次 和 类 之 间 的 依赖 关系 。 


| 用户 界 面 层 _ 


<<|NTERFACE> > 
IAccountService 


+AddTransaction 


<<INTERFACE>> 
IAccountRepository 


+GetByName(string name) 








图 4-4 ”依赖 和 实现 构成 了 你 将 要 测试 的 子 系统 
上 面 的 UML 图 展示 的 三 个 包 表 达 的 是 三 层 架 构 的 方案 。 用 户 界 面 层 包含 了 了 MVC 控制 带 
( Model-View-Controller， MVC )， 也 可 以 使 用 MVVM ( Model-View-ViewModel，MVVM ) 或 者 
MVP ( Model-View-Presenter，MVP ) 来 替代 MVC。 具 体 来 说 ，AccountController 类 会 有 处理 
用 户 界 面 在 革 个 账户 上 进行 交易 的 方法 。 这 个 控制 器 类 依赖 IAccountService 接 口 ， 而 
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AccountService 类 则 会 实现 该 接口 。 

AccountService 类 和 它 的 接口 以 及 域 模型 Account 类 都 属于 业务 逻辑 层 。 注 意 ， 这 里 的 包 
表达 的 是 应 用 程序 的 逻辑 层 ， 而 不 是 能 直接 映射 到 Microsoft Visual Studio 当 中 的 工程 或 程序 集 。 
这 种 分 层 方式 采用 的 是 阶梯 模式 ， 而 不 是 随从 反 模 式 。AccountServi ce 类 会 需要 以 某 种 方式 从 
你 使 用 的 持久 存储 中 获取 Account 类 的 实例 。 因 为 你 在 业务 逻辑 层 定 义 了 域 模型 ， 所 以 数据 访问 
层 可 以 使 用 对 象 关 系 映射 句 (ObjecVRelational Mapper，ORM ) 来 实现 。 

数据 访问 层 的 存储 库 接 口 用 于 隐藏 具体 的 持久 存储 逻辑 。IAccountRepository 接 口 负责 返 
回 Account 类 的 实例 。 服 务 依赖 这 个 接口 ， 因 为 该 服务 的 实现 需要 检索 Account 类 的 实例 。 

2. 设计 测试 

与 前 面 几 市 一 样 ， 采 用 测试 驱动 开发 的 方法 以 及 布置 、 动 作 和 断言 模式 来 编写 Account- 
Service 类 的 AddTransactionToAccount 方 法 的 测试 。 首 先 ， 你 需要 想 清 楚 对 这 个 方法 的 期 望 : 
找到 正确 的 Account 类 实例 ， 委 托 它 的 AddTransaction 方 法 ， 并 把 正确 交易 金额 传人 到 该 方法 
中 。 下 面 详细 说 明 布 置 、 动 作 和 断言 阶段 。 

口 布置 : 确保 有 可 用 的 测试 目标 系统 (AccountService 类 ) 的 实例 。 

口 动作 : 调用 它 的 AddTransactionToAccount 方 法 。 

口 断言 : 测试 目标 系统 通过 调用 Account 类 实例 的 AddTransaction 方 法 并 把 正确 的 交易 金 

额 传 入 。 
代码 清单 4-12 展 示 了 该 测试 的 第 一 个 版 本 。 


代码 清单 4-12 ”该 测试 的 第 一 个 版 本 


[TestClass] 
public class AccountServiceTests 


{ 














[TestMethod] 
public void AddingTransactionToAccountDelegatesToAccountInstance() 


{ 
// Arrange 
var sut = new AccountService(C) ; 


// Act 
sut.AddTransactionToAccount("Trading Account", 200m); 


// Assert 
Assert.FailQO; 


} 





断言 前 的 代码 看 起 来 都 没什么 问题 。 断言 就 是 调用 某 个 对 象 的 某 个 特定 的 方法 并 把 某 个 具体 
的 值 传 信 ， 但 是 你 又 如 何 断言 呢 ? 此 时 就 需要 模拟 了 。 

3. 使 用 临时 实现 测试 

这 个 示例 中 ， 你 首先 要 获得 一 个 Account 类 的 实例 ， 然 后 才 可 以 编写 对 该 实例 对 象 的 断言 。 
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因为 AccountService 类 还 需要 使 用 IAccountRepository 接 口 检 索 想 要 的 Account 类 实例 ,所 以 
你 不 能 直接 给 AccountService 类 一 个 Account 类 的 实例 。 相反 , 你 需要 给 AccountService 类 一 
个 IAccountRepository 接 口 的 实例 , 但 是 你 并 没有 任何 该 接口 的 实现 可 用 。 此 时 就 需要 目 己 编 
写 一 个 只 用 于 测试 该 接口 的 临时 实现 类 ， 因 为 你 依赖 的 是 接口 而 不 是 类 型 。 代 码 清单 4-13 展 示 了 
这 样 的 一 个 类 ， 它 本 喘 属 于 单元 测试 程序 集 。 


代码 清单 4-13 一 个 只 用 于 测试 的 存储 库 接口 的 临时 实现 


public class FakeAccountRepository : IAccountRepository 











{ 
public FakeAccountRepository(Account account) 
{ 
this.account = account; 
} 
public Account GetByName(string accountName) 
{ 
return account; 
} 
private Account account; 
} 


现在 ， 你 可 以 编辑 AccountService 类 实现 从 而 能 够 提供 这 个 临时 存储 库 实例 了 。 代 码 清 
4-14 展 示 了 更 新 后 的 AccountService 类 的 实现 。 


代码 清单 4-14 ”更 新 的 AccountServi ce 类 


public class AccountService : IAccountService 


{ 
public AccountService(IAccountRepository repository) 
{ 
this.repository = repository; 
} 
public void AddTransactionToAccount(string uniqueAccountName, decimal transactionAmount) 
{ 
} 
private readonly IAccountRepository repository; 
} 





现在 能 够 完成 这 个 单元 测试 了 ， 只 是 更 新 了 布置 的 标准 。 

口 确保 有 个 可 用 的 Account 类 实例 来 做 断言 。 

口 确保 为 服务 的 构造 函数 传 入 一 个 可 用 的 IAccountRepository 接 口 的 临时 实现 类 的 实例 。 
代码 清单 4-15 中 的 失败 测试 包括 了 这 些 更 新 的 标准 和 正确 的 断言 代码 。 
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代码 清单 4-15 ”这 个 测试 肯定 会 失败 ， 因 为 服务 方法 还 没有 任何 具体 实现 


[TestClass] 
public class AccountServiceTests 
{ 
[TestMethod] 
public void AddingTransactionToAccountDelegatesToAccountInstance() 
{ 
// Arrange 
var account = new Account() ; 
var fakeRepository = new FakeAccountRepository(account); 
var sut = new AccountService(fakeRepository); 


// Act 
sut.AddTransactionToAccount("Trading Account", 200m); 


// Assert 
Assert.AreEqual1(200m，account.Balance) ; 


首先 你 创建 了 一 个 账户 余额 为 0 的 新 账户 。 在 此 基础 上 ， 你 创建 了 一 个 临时 账户 存储 库 实现 
类 的 实例 。 这 个 实例 也 实现 了 IAccountRepository 接 口 ,所 以 可 以 把 它 传人 到 AccountService 


类 的 构造 函数 中 ， 这 也 是 该 测试 中 的 测试 日 标 系统 。 


在 调用 了 要 测试 的 目标 方法 后 ， 你 就 可 以 断言 该 账户 的 余额 是 否 变 为 了 200m。 图 4-5 展 示 了 


测试 运行 失败 的 截图 ， 因 为 该 方法 还 没有 任何 具体 实现 。 


Test Explorer we 
[EE ~ | Search A- 
Run All | Run.. ~ | Playlist:AllTests 

4 Failed Tests (1) AddingTransactionToAccountDelegatesToAccountlnstance 





(Xx) AddingTransactionToAccountDelegatesToAccountlnstance 


Source: AccountServiceTests.cs line 15 
四 Test Failed - AddingTransactionToAccountDelegatesToAccountlnstance 
Message: Assert.AreEqual failed. Expected:<200>. Actual:<0>- 
Elapsed time: 35 ms 
4 StackTrace: 
AccountServiceTests.AddingTransactionToAccountDelegatesToAccountinstancel 





图 4-5 在 这 个 失败 的 测试 基础 上 ， 需 要 继续 对 它 进 行 改 进 以 让 红 变 绿 
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至 此 , 你 已 经 准备 好 了 针对 某 些 未 实现 行为 的 单元 测试 , 可 以 从 让 该 测试 通过 的 最 简单 实现 


开始 编写 产品 代码 ， 如 代码 清单 4-16 所 示 。 
代码 清单 4-16 ”AccountServi ce 类 的 一 个 能 让 测试 通过 的 实现 


public class AccountService : IAccountService 


{ 
public AccountService(IAccountRepository repository) 
{ 
this.repository = repository; 


} 
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public void AddTransactionToAccount(string uniqueAccountName, decimal 
transactionAmount) 
1 
var account = repository.GetByName (uniqueAccountName); 
account.AddTransaction(transactionAmount); 


} 


private readonly IAccountRepository repository; 


} 


单元 测试 驱动 着 你 去 做 正确 的 实现 。 你 必须 使 用 存储 库 来 获得 账户 , 还 必须 调用 该 账户 实例 
的 AddTransaction 方 法 来 改变 只 读 的 Balance 属 性 。 如 果 后 续 有 人 对 该 单元 测试 的 改动 导致 不 
能 满足 测试 期 望 时 ， 会 立即 看 到 失败 的 结 

4. 使 用 模拟 测试 

如 果 青 多 想 想 , 你 就 会 认识 到 编写 接口 的 临时 实现 类 很 快 会 变 得 不 现实 了 。 想 想 你 要 编写 的 
单元 测试 的 数目 以 及 各 种 测试 目标 系统 需要 实现 的 各 种 不 同 的 接口 , 你 就 明白 仅仅 为 了 支持 你 的 
单元 测试 ， 编 写 临 时 实现 类 会 需要 大 量 的 编码 工作 。 

还 有 另外 一 种 模拟 IAccountRepository 接 口 的 方式 , 但 是 这 种 方式 需要 外 部 模拟 框架 的 支 
持 。 上 自己 动手 编写 接口 的 临时 实现 类 的 好 人 处 在 于 无 需 引 入 第 三 方 依赖 ， 尺 管 如 此 ， 随 着 现在 各 种 
模拟 框架 的 普及 , 引入 一 个 这 样 的 公开 的 第 三 方 依赖 是 可 以 接受 的 。 下 面 的 示例 使 用 了 最 流行 的 
一 个 模拟 框架 : Moq， 有 时候 也 称 为 Moh-kyoo 或 Mok。 

你 可 以 使 用 NuGet 快 速 检索 Moq 的 在 线 包 并 将 它 添加 到 工程 引用 中 。Moq 的 神奇 之 处 在 于 它 
能 动态 创建 任何 你 想 模拟 的 接口 的 代理 。 代 码 清单 4-17 是 用 Moq 模 拟 替 代 上 自己 编 写 的 临时 实现 类 
后 的 测试 代码 。 


代码 清单 4-17 ”诸如 Moq 之 类 的 模拟 框架 能 轻松 创建 用 于 测试 的 奉 代 实现 


[TestMethod] 
public void AddingTransactionToAccountDelegatesToAccountInstance() 


{ 

















// Arrange 

var account = new Account(); 

var mockRepository = new Mock<IAccountRepository>©O; 

mockRepository.Setup(r => r.GetByName("Trading Account")) .Returns(account); 
var sut = new AccountService(mockRepository.Object); 


// Act 
sut.AddTransactionToAccount("Trading Account", 200m); 


// Assert 
Assert.AreEqual(200m,account.Balance); 


} 


上 面 示例 中 加 粗 的 改动 部 分 不 再 是 初始 化 自己 编写 的 库 的 临时 实现 类 ， 而 是 创建 了 新 的 
Mock<IAccountRepository>() 对 象 。 这 个 对 象 很 强大 , 能 够 让 你 在 要 模拟 的 接口 上 设置 各 种 期 
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望 和 行为 。Mock 类 不 会 实现 你 的 接口 ， 因 此 ， 它 不 会 像 你 的 临时 实现 一 样 能 直接 得 到 一 个 
IAccountRepository 接 口 的 实例 。 这 是 因为 公共 语言 运行 时 并 不 允许 从 泛 型 参数 继承 。 相 反 ， 
被 模拟 者 和 所 创建 的 代理 实例 之 间 是 组 合 的 关系 。 上 面 示例 中 传人 到 AccountService 类 构造 也 
数 中 的 0bject 属 性 提供 了 访问 被 模拟 接口 的 方式 。 

你 在 给 测试 目标 系统 提供 模拟 对 象 前 ， 需 要 定义 该 模拟 对 象 的 行为 。Moq 默 认定 义 的 是 宽松 
模拟 ， 这 意味 着 模拟 对 象 的 所 有 返回 都 是 defau1t。 任 何 引 用 类 型 的 默认 值 都 是 nu11， 这 也 适用 
于 Account 类 。 另 外 一 种 方式 是 严格 模拟 ， 对 这 种 模拟 对 象 上 你 没有 预先 定义 的 属性 和 方法 的 访 
问 都 会 引起 异常 。 无 论 选择 哪 种 模拟 方式 ， 你 都 必须 手动 对 创建 的 模拟 对 象 设 置 期 望 的 行为 。 

Mock 实 例 的 Setup 方 法 设计 得 很 巧妙 。 它 能 接受 lambda 表 达 式 ， 表 达 式 中 的 上 下 文 参数 就 是 
被 模拟 类 的 实例 。 你 可 以 通过 调用 被 模拟 类 的 方法 并 传人 实际 的 参数 来 高 效 定义 调用 该 方法 时 你 
所 期 望 的 行为 。 在 不 同 的 上 下 文中 ,期 望 的 行为 可 以 不 同 。Moq 能 让 你 在 一 个 方法 调用 内 设置 以 
下 期 望 值 。 

口 调用 lambda 表 达 式 。 

口 返回 一 个 指定 的 值 。 

口 引发 一 个 指定 类 型 的 异常 。 

口 确保 该 方法 被 调用 。 

对 于 当前 这 个 示例 ， 你 所 期 望 的 是 : 返回 一 个 指定 的 值 。Mock.Setup 方 法 的 流 接 口 允许 在 
Return 方 法 返回 的 Mock 实 例 上 进行 链 式 调用 。 这 种 链 式 调用 可 以 改善 可 读 性 并 且 避 免 测试 的 布 
置 代 码 过 于 庞大 。Return 方 法 假设 的 前 提 是 要 指定 返回 的 Account 实 例 已 经 就 绪 。 简单 地 说 ,你 
给 Mock 下 达 了 以 下 指令 。 


如 果 在 调用 IAccountRepository 实 例 的 GetByName 方 法 时 传 入 值 为 Trading 
Account 的 账户 名 参数 ， 请 返回 指定 的 Account 类 实例 。 


与 前 面 的 示例 一 样 ， 青 次 运行 这 个 测试 的 结果 会 是 成 功 的 。 图 4-6 是 运行 结果 截图 。 




















Test Explorer 日 关 
[EE ~ | Search 及 -> 
Run All | Run... v | Playlist : AllTests 

4 Passed Tests (1) AddingTransactionToAccountDelegatesToAccountlnstance 





CO) AddingTransactionToAccountDelegatesToAccountlnstance 5 A 


名 Test Passed - AddingTransactionToAccountDelegatesToAccountlnstance 
Elapsed time: 29 ms 


图 4-6 在 使 用 Moq 模 拟 后 ， 测 试 结果 是 成 功 的 
在 庆祝 测试 通过 前 , 你 需要 承认 你 刚才 欺骗 了 测试 运行 右 。 有 时 ,你 对 某 些 失败 的 单元 测试 
的 编辑 并 不 会 让 测试 结果 由 红 变 绿 。 有 时 ,无 论 你 对 某 些 成 功 的 单元 测试 的 编辑 是 什么 , 它 始终 
是 成 功 的 状态 ,为 了 达到 让 单元 测试 完 失 败 然后 只 有 用 正确 的 测试 目标 系统 的 实现 才能 让 其 通过 
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再 次 验证 的 日 标 ， 你 应 该 先 把 AddTransactionToAccount 方 法 的 代码 删除 掉 ， 然 后 恢复 代码 后 
再 次 验证 以 确认 这 些 实现 代码 能 让 这 个 测试 通过 。 这 种 编辑 方式 在 单元 测试 流程 中 非常 重要 , 它 
能 规避 出 现 假 正确 的 现象 ， 假 正确 是 指 实现 上 并 不 正确 的 单元 测试 也 通过 了 验证 。 





模拟 和 过 度 测试 

使 用 模拟 测试 这 种 实践 很 常见 ， 但 也 会 带 来 潜在 的 问题 。 因 为 基于 模拟 的 测试 很 容易 变 
得 过 度 。 过 度 规 定 的 测试 很 脆弱 ,但 你 可 以 通过 改变 断言 来 避免 出 现 这 种 现象 。 如 果 编写 测 
试 的 人 非常 熟悉 测试 目标 系统 的 内 部 原理 ,就 容易 出 现 这 种 现象 ， 换 和 句 话说 ,过 度 规定 的 测 
试 是 针对 测试 目标 系统 的 实现 编写 的 ， 而 不 是 针对 测试 目标 系统 所 期 望 的 行为 编写 的 。 

当然 , 使 用 模拟 的 单元 测试 需要 知道 测试 目标 系统 是 否 已 经 实现 , 但 是 要 切记 单元 测试 
规定 的 是 所 期 望 的 行为 ,而 不 是 实现 细节 ， 比 如 对 测试 目标 系统 可 能 要 依赖 的 其 他 接口 的 调 
用 等 。 如 果 你 的 断言 是 必须 要 调用 某 个 接口 的 某 个 方法 ， 那 么 这 个 测试 已 经 关联 了 某 个 具体 
实现 而 不 是 某 个 特定 行为 。 

过 度 规定 的 测试 会 阻碍 对 产品 代码 的 重 构 。 如 果 一 组 单元 测试 要 与 某 个 方法 或 者 类 同时 
出 现 , 这 就 表明 可 以 随意 修改 该 方法 或 者 类 的 实现 ,正确 的 测试 只 有 在 代码 行为 被 破坏 时 才 
会 失败 ,但 是 过 度 规定 的 测试 无 法 提供 这 种 保证 ,因为 它们 会 在 该 方法 和 类 的 实现 改变 时 失 
败 ， 即 使 期 望 的 行为 依然 是 完整 的 。 

有 两 种 方式 可 以 避免 在 使 用 模拟 测试 时 出 现 过 度 规定 的 现象 。 第 一 种 是 只 针对 行为 测 
试 。 基于 状态 的 测试 就 是 一 种 很 好 的 只 测试 期 望 行为 的 方式 。 如 果 一 个 方法 接受 某 个 数据 输 
入 后 返回 该 数据 修改 后 的 值 , 这 个 方法 内 部 对 测试 而 言 就 是 黑金 。 如果 一 个 方法 接受 数据 A、 
B 和 C 后 返回 了 数据 X、Y 和 7Z， 那 么 测试 不 应 当知 道 A、B 和 C 是 如 何 导出 X、Y 和 2 的 。 在 不 
影响 单元 测试 的 前 提 下 ， 该 方法 后 面 会 被 修改 。 

第 二 种 方式 不 常用 , 但 是 有 时 候 不 得 不 使 用 。 你 需要 把 单元 测试 和 测试 目标 方法 看 作 一 
个 整体 : 两 者 必须 同时 改动 。 如 果 代 码 从 不 需要 重 构 ， 你 可 以 把 单元 测试 和 产品 实现 绑 定 在 
一 起 ， 也 相当 于 承认 了 该 单元 测试 是 过 度 规 定 的 。 本 书 第 二 部 分 也 会 讲 到 ，SOLID 代 码 中 会 
经 常 包 含 很 多 从 不 会 修改 的 更 直接 的 小 规模 类 。 


5. 更 进一步 的 测试 

第 一 步 ， 你 尝试 了 用 测试 驱动 开发 的 方法 成 功 完成 一 个 可 以 工作 的 AccountService 类 。 不 
过 ,该 类 定义 中 还 有 一 些 潜在 的 问题 ,这 需要 有 更 进一步 的 测试 来 确保 类 方法 足够 的 健壮 。 到 现 
在 为 止 ， 上 面 的 示例 只 要 对 代码 的 执行 路 径 的 测试 没有 发 现 问题 和 错误 ， 你 就 觉得 心满意足 了 。 
但 是 ， 实 际 上 还 是 需要 考虑 以 下 这 些 其 他 因素 。 

口 如 果 账 户 存 储 库 是 个 空 引用 ? 

口 如 果 在 存储 库 中 找 不 到 指定 名 称 的 账户 ? 

口 如 果 账 户 的 方法 引发 了 异常 ? 
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每 当 增 加 一 个 新 的 测试 时 , 你 要 么 在 测试 失败 时 无 法 确保 履 盖 实 现 的 所 有 缺陷 , 要 么 在 测试 
成 功 时 相信 自己 的 实现 对 正常 代码 执行 路 径 和 错误 路 径 都 是 正确 的 。 

在 什么 情况 下 账户 存储 库 可 能 是 空 引 用 呢 ? 这 种 情况 只 会 发 和 后 在 AccountService 类 的 构造 
印 数 的 输入 参数 也 为 空 的 情况 下 。 因 为 有 效 的 账户 存储 库 需 要 依赖 账户 服务 , 所 以 你 可 以 说 这 是 
该 构造 函数 的 前 提 ( precondition )。 为 此 ， 你 可 以 像 代 码 清单 4-18 这 样 编写 测试 。 


代码 清单 4-18 没有 布置 和 晰 言 的 测试 是 一 种 测试 异常 的 有 效 模 式 


[TestMethod] 
[ExpectedException(typeof (ArgumentNullException))] 
public void CannotCreateAccountServiceWithNullAccountRepository() 








{ 
// Arrange 
// Act 
new AccountService(null); 
// Assert 
} 


这 个 测试 与 前 面 的 测试 的 断言 方式 不 一 样 。MSTest 为 这 种 测试 提供 了 ExpectedException- 
Attribute 属 性 ， 该 属性 的 参数 代表 了 你 期 望 的 异常 类 型 。 上 面 示 例 中 的 代表 了 你 期 望 
AccountService 类 的 构造 国 数 的 输入 参数 是 一 个 IAccountRepository 实 例 的 nu11 引 用 时 应 该 
引发 一 个 ArgumentNu11Exception 类 的 异常 。 这 个 新 的 测试 就 是 你 需要 的 前 置 条 件 ， 它 能 保证 
其 他 使 用 账户 服务 的 测试 方法 总 是 有 个 有 效 的 实例 ， 因 此 也 无 需 再 去 做 nul11 引 用 的 判断 和 处 理 。 
这 个 方法 会 像 期 望 的 那样 失败 ， 具 体 信息 如 下 所 示 。 

Test method 

ServiceTests.AccountServiceTests.CannotCreateAccountServiceWithNullAccountRepository 

did not throw an exception. An exception was expected by attribute 


Microsoft.VisualStudio.TestTools.UnitTesting.ExpectedExceptionAttribute defined on the test 
method. 


为 了 让 这 个 测试 通过 ,你 需要 在 产品 代码 中 实现 前 置 条 件 检 测 。 代 码 清单 4-19 给 出 了 一 种 实 
现 方式 。 
代码 清单 4-19 ”给 构造 函数 传 入 空 的 账户 存储 库 会 引发 异常 


public AccountService(IAccountRepository repository) 


{ 




















if (repository == nul1) throw new ArgumentNullException("repository", "A valid account 
repository must be supplied.…) ; 


this.repository = repository; 


示例 中 加 粗 的 就 是 新 增 的 代码 。 这 种 方式 可 以 确保 你 尽快 失败 。 如 果 不 设 置 这 种 前 置 条 件 ， 
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最 终 会 引发 的 是 一 个 Nul1lReferenceException 异 常 ， 它 会 发 生 在 你 第 一 次 尝试 访问 这 个 nu11 
存储 库 实例 的 时 候 。 

在 构造 函数 测试 通过 后 , 你 就 可 以 处 理 在 存储 库 中 找 不 到 匹配 账户 的 情况 了 。 假设 你 的 存储 
库 代 码 并 没有 实现 空 对 象 模 式 ， 这 种 模式 在 第 3 章 中 介绍 过 ， 它 能 够 避免 返回 nu11 对 象 或 者 在 存 
储 库 找 不 到 请 求 的 对 象 时 引发 异常 。 相 反 ， 这 个 示例 中 ， 你 的 存储 库 代码 应 该 返回 一 个 账户 的 
nu11 引 用 。 代 码 清单 4-20 展 示 了 一 个 强制 出 现 这 种 期 望 行为 的 单元 测试 。 


代码 清单 4-20” 既 没有 期 望 异常 属性 也 没有 断言 的 单元 测试 


[TestMethod] 
public void DoNotThrowwhenAccountIsNotFound () 











// Arrange 
var mockRepository = new Mock<IAccountRepository>() ; 
var sut = new AccountService(mockRepository.0Object); 


// Act 
sut.AddTransactionToAccount("Trading Account", 100m); 


// Assert 
} 


这 个 新 的 单元 测试 中 断言 部 分 是 空白 的 ， 也 没有 ExceptedException 属 性 。 这 是 因为 你 的 
期 望 就 是 动作 部 分 代码 不 应 该 引发 任何 异常 。 如 果 有 异 稼 引发 , 那么 测试 就 失败 了 ， 如 果 测 试 代 
码 没 有 任何 异常 引发 ( 也 没有 其 他 可 能 导致 失 败 的 断言 )， 那 么 该 测试 默认 就 是 成 功 的 。 

示例 测试 的 布置 阶段 ， 模 拟 了 存储 库 并 把 它 传 给 测试 目标 系统 ( 提供 了 一 个 有 效 的 存储 库 实 
例 来 满足 前 置 条 件 ) 但 是 没有 对 它 设 置 期 望 的 行为 。 这 就 意味 着 对 IAccountRepository. 
GetByName() 方法 的 调用 会 返回 nul1。 然 后 在 返回 对 象 的 基础 上 党 试 调用 Account. 
AddTransaction() 方 法 。 因 为 是 个 nu11 实 例 ， 所 以 会 引起 一 个 NullReferenceException 异 常 
并 导致 测试 失败 。 为 了 让 该 测试 由 红 变 绿 ， 你 需要 在 方法 实现 中 引发 该 异 背 ， 如 代码 清单 4-21 
DA 


代码 清单 4-21 使 用 if 语句 防止 方法 引发 Nu11ReferenceException 异 名 


public void AddTransactionToAccount(string uniqueAccountName, decimal transactionAmount) 














{ 
var account = repository.GetByName (uniqueAccountName); 
if (account != null) 
{ 
account.AddTransaction(transactionAmount); 
} 
} 


通过 增加 一 条 简单 的 1f 语 句 来 在 使 用 前 先 判 断 账 户 对 象 是 否 为 nu11， 就 可 以 防止 该 方法 引 
发 Nul11ReferenceException 异 常 了 ， 同 时 也 保证 了 对 应 的 单元 测试 是 成 功 的 。 
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最 后 一 个 需要 增加 的 单元 测试 是 针对 当 账 户 的 AddTransaction 方 法 引发 异常 时 账户 服务 的 
期 望 行为 而 设计 的 。 为 了 避免 分 层 间 的 依赖 汇 漏 , 一 个 好 的 实践 方式 是 在 当前 层 用 一 个 新 的 异常 








来 封闭 从 底层 引发 的 异常 。 图 4-7 展 示 了 这 个 方式 。 








----DomainException------— 

1 

一- " ServiceException -- -~ 1 

1 1 

1 1 

1 1 

1 1 1 
1 1 1 


图 4-7 ”每 个 层 都 定义 自己 的 异常 类 型 来 封装 来 自 更 低层 的 异常 


域 模 型 引发 的 异常 是 针对 域 模型 设计 的 ， 如 果 服 务 层 允许 这 种 低层 次 的 异常 引发 给 控制 妖 ， 
这 会 要 求 控制 右 清 楚 DomainException 类 以 便 高 效 地 捕获 并 处 理 这 类 异常 ,这 明显 会 引入 你 并 不 
想 看 到 的 控制 器 和 域 模 型 层 间 的 依赖 关系 。 相 反 , 服务 层 应 该 自己 负责 捕获 域 模型 的 异常 并 将 其 
封装 在 ServiceException 异 销 实 例 中 ， 然 后 才 引 发 给 控制 袁 。 因 为 控制 咒 本 身 是 依赖 服务 层次 
的 , 因此 它 可 以 , 也 应 该 , 处 理 服务 层 引 发 的 任何 异常 。 这 里 要 清楚 的 一 点 是 , DomainException 
类 要 作为 ServiceException 类 的 内 部 成 员 ， 如 果 不 这 样 做 ， 你 就 会 失去 很 有 价值 的 引发 原始 异 
篆 的 上 下 文 信息 。 代 码 清 单 4-22 展 示 了 确保 你 的 多 个 类 协同 实现 这 种 期 望 行为 的 单元 测试 。 


代码 清单 4-22 ”调用 模拟 的 账户 时 会 引发 异 稼 


[TestMethod] 
[ExpectedException(typeof(ServiceException))] 
public void AccountExceptionsAreWrappedInThrowServiceException() 


{ 














// Arrange 

var account = new Mock<Account>(D) ; 

account.Setup(a => a.AddTransaction(100m) ) .Throws<DomainException>() ; 

var mockRepository = new Mock<IAccountRepository>() ; 

mockRepository.Setup(r => r.GetByName("Trading Account")).Returns(account.Object); 
var sut = new AccountService(mockRepository.Object); 


// Act 
sut.AddTransactionToAccount("Trading Account", 100m); 
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// Assert 
} 





示例 中 的 期 望 异常 属性 用 于 断言 测试 目标 系统 是 否 引 发 了 一 个 ServiceException 异 党， 而 
代码 中 模拟 的 账户 实例 则 会 去 引发 一 个 DomainException 异 常 。 因 此, 由 测试 目标 系统 负责 异常 
之 间 的 转换 。 现在 你 的 产品 代码 中 的 方法 还 没有 进行 这 个 异常 转换 ,所 以 测试 会 像 期 望 的 那样 失 
败 ， 具 体 信息 如 下 所 示 。 

Test method 

ServiceTests.AccountServiceTests .AccountExceptionsAreWrappedInThrowServiceException 

threw exception Domain.DomainException, but exception Services.ServiceException was expected. 


Exception message: Domain.DomainException: Exception of type 'Domain.DomainException' was 
thrown. 


期 望 异常 属性 会 判断 引发 的 异常 是 否 是 指定 的 异常 类 型 。 代 码 清单 4-23 展 示 了 需要 在 Add- 
TransactionToAccount 方 法 中 所 做 的 改动 。 


代码 清单 4-23 引入 的 try/catch 代 码 块 中 包括 了 异常 的 转换 


public void AddTransactionToAccount(string uniqueAccountName, decimal transactionAmount) 








{ 
var account = repository.GetByName (uniqueAccountName); 
if (account != null) 
{ 
try 
1 
account.AddTransaction(transactionAmount); 
} 
catch(DomainException) 
1 
throw new ServiceException() ; 
} 
} 
} 


尽管 引入 try/catch 代 码 块 能 让 上 面 的 测试 由 红 变 绿 ， 但 是 ServiceException 异 常 并 没有 
包含 DomainException 异 常 ， 也 就 是 说 ， 测 试 工 作 依然 没有 完成 。 

6. 为 修复 缺陷 编写 测试 

想象 一 下 你 收 到 了 一 个 现 有 示例 代码 的 缺陷 报告 。 该 报告 中 有 下 面 这 样 一 句 描 述 。 

我 在 我 的 账号 上 做 交易 时 收 到 了 一 个 ServiceException 异 常 。 

于 是 你 着 手 去 重 现 这 个 问题 并 发 现 了 引发 的 异常 ,这 也 是 问题 最 可 能 的 根源 ,但 是 , Service- 
Exception 异 常 取 代 了 DomainException 异 常 ， 因 此 很 难 理解 问题 的 最 根本 原因 。 前 面 的 代码 
中 ， 原 有 的 异常 并 没有 被 包含 在 新 的 异常 中 ， 因 为 你 的 单元 测试 中 并 没有 断言 来 确保 这 一 点 。 

当 你 收 到 这 样 的 缺陷 报告 时 , 应 该 做 的 第 一 件 事 就 是 编写 一 个 要 失败 的 单元 测试 来 捕获 两 件 
事 : 确保 缺陷 发 生 的 必需 的 具体 复 现 步 又 以 及 旧 的 单元 测试 遗漏 的 期 望 行为 。 代 码 清单 4-24 中 的 
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单元 测试 包含 了 需要 完成 的 两 件 事 。 
代码 清单 4-24 手动 断言 要 引发 的 异常 的 示例 


[TestMethod] 
public void AccountExceptionsAreWrappedInThrowServiceException() 
{ 
// Arrange 
var account = new Mock<Account>Q); 
account.Setup(a => a.AddTransaction(C100m) ) .Throws<DomainException>() ; 
var mockRepository = new Mock<IAccountRepository>QO; 
mockRepository.Setup(r => r.GetByName("Trading Account")).Returns(account.Object); 
var sut = new AccountService(mockRepository.Object); 





// Act 
try 
{ 
sut.AddTransactionToAccount("Trading Account", 100m); 
于 
catch(ServiceException serviceException) 
{ 
// Assert 
Assert.IsInstanceOfType(serviceException.InnerException, typeof(DomainException)); 
} 


对 于 这 个 测试 ， 单 单 使 用 ExpectedException 属 性 是 不 够 的 。 你 需要 自己 编写 代码 来 断言 
引发 ServiceException 异 常 的 InnerException 成 员 是 否 为 DomainException。 这 个 断言 可 以 
证 明 你 已 经 封装 了 域 异常 并 保留 了 原始 错误 发 生 的 上 下 文 信息 。 所 有 软件 缺陷 都 可 以 看 作对 应 单 
元 测试 的 缺失 : 期 望 行为 的 规范 不 人 够 完整 。 代 码 清单 4-25 展 示 了 让 该 单元 测试 通过 验证 对 产品 代 
码 所 做 的 修改 。 


代码 清单 4-25 ”新 的 异常 封 淘 了 原始 异常 


public void AddTransactionToAccount(string uniqueAccountName, decimal transactionAmount) 


{ 
var account = repository.GetByName (uniqueAccountName); 
if (account != null) 
{ 
try 
{ 
account.AddTransaction(transactionAmount); 
} 
catch(DomainException domainException) 
1 
throw new ServiceException("An exception was thrown by a domain object", 
domainException); 
} 


} 
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通过 这 个 测试 后 ,你 可 以 再 次 尝试 重 现 报告 中 提 及 的 异常 ,这 一 次 , 你 可 以 判断 问题 的 根本 
原因 了 。 

7. 测试 初始 化 

我 们 一 起 回顾 一 下 目前 你 所 写 的 所 有 测试 。 每 一 个 都 逐步 变 得 越 来 越 复杂 ,需要 加 入 更 多 代 
码 来 设 定 你 的 期 望 。 如 果 你 能 整理 出 公共 测试 代码 并 缩短 这 些 测 试 代码 ,这 样 也 很 好 。 与 其 他 单 
元 测试 框架 一 样 , MSTest 允 许 你 在 测试 类 型 内 为 所 有 测试 方法 编写 公共 的 初始 化 方法 。 你 可 以 为 
这 个 初始 化 方法 任意 命名 ,但 是 必须 要 之 有 TestInitialize 属 性 。 

初始 化 方法 包括 了 几乎 所 有 单元 测试 都 需要 的 公共 代码 : 初始 化 模拟 对 象 。 你 可 以 把 模拟 对 
象 保存 在 测试 类 型 的 私有 数据 对 象 中 , 这样 每 个 测试 方法 都 可 以 访问 它们 。 同 样 , 也 可 以 将 测试 
系统 存放 在 测试 类 型 的 私有 数据 中 ,因为 上 面 的 示例 中 , 测试 目标 系统 除了 在 构造 函数 需要 模拟 
的 存储 库 实例 作为 输入 参数 外 ， 它 并 不 依赖 其 他 任何 因 单 元 测试 而 异 的 元 素 。 代 码 清 单 4-26 展 示 
了 在 测试 类 型 中 支持 初始 化 方法 所 需要 的 改动 。 


代码 清单 4-26 ”可 以 在 初始 化 方法 中 构造 模拟 对 象 和 测试 目标 系统 


[TestClass] 
public class AccountServiceTests 


{ 











[TestInitializel] 

public void Setup() 

{ 
mockAccount = new Mock<Account>(); 
mockRepository = new Mock<IAccountRepository>Q); 
sut = new AccountService(mockRepository.Object); 


} 


private Mock<Account> mockAccount; 
private Mock<IAccountRepository> mockRepository; 
private AccountService sut; 


} 





每 个 测试 方法 都 会 单独 调用 构造 这 些 模拟 对 象 和 测试 目标 系统 的 初始 化 方法 , 这 样 你 就 可 以 
通过 移 除 对 象 构 造 代 码 来 简化 某 些 单元 测试 。 代 码 清 单 4-27 展 示 了 对 最 后 编写 的 Account- 
ExceptionAreWrappedInThrowServiceException 测 试 方法 的 改动 。 
代码 清单 4-27 ”简化 后 的 测试 方法 代码 更 短 且 更 易 阅 读 

[TestMethod] 


public void AccountExceptionsAreWrappedInThrowServiceException() 


{ 





// Arrange 
mockAccount.Setup(a => a.AddTransaction(100m)) .Throws<DomainException>() ; 
mockRepository.Setup(r => Pr.GetByName( "Trading Account")).Returns(mockAccount.Object); 


// Act 


4.2 重 构 131 


try 
{ 
sut.AddTransactionToAccount("Trading Account", 100m); 


catch(ServiceException serviceException) 
{ 
// Assert 
Assert.IsInstanceOfType(serviceException.InnerException, typeof(DomainException)); 
} 
} 


虽然 在 一 个 方法 内 只 移 除了 三 行 代码 , 看 起 来 作用 并 没有 那么 明显 , 但 是 让 所 有 的 单元 测试 
都 变 得 简短 的 效果 累积 后 就 能 得 到 更 高 的 可 读 性 。 众 所 周知 ， 按 照 约定 ,示例 代 码 中 变量 名 的 
mock 前 级 代表 了 该 变量 是 模拟 对 象 的 实例 ， 而 sut 变 量 则 代表 了 你 要 测试 目标 系统 的 实例 。 


4.2 重 构 


如 果 你 按照 测试 驱动 开发 流程 在 实现 期 望 行为 前 先 编写 一 个 注定 失败 的 单元 测试 , 你 的 代码 
就 会 更 加 健壮 。 尽 管 如 此 , 代码 的 组 织 也 许 会 变 得 不 易 理 解 。 在 编码 过 程 中 , 很 多 时 候 都 应 该 停 
下 手头 的 单元 测试 和 产品 代码 开发 ， 从 而 集中 精力 去 重 构 已 有 的 代码 。 

重 构 ( refactoring ) 是 一 个 改善 现 有 代码 设计 的 过 程 。 每 次 重 构 的 规模 和 范围 会 有 不 同 ， 花 
半分 钟 给 变量 改 一 个 更 明确 的 名 称 是 一 次 重 构 , 必要 时 将 用 户 界面 层 逻 辑 和 域 逻 辑 分 离开 , 这 样 
影响 巨大 的 架构 改动 也 是 一 次 重 构 。 


4.2.1 更 改 已 有 代码 


接 下 来 ， 你 会 通过 实践 逐步 改善 同一 个 类 型 的 代码 ， 每 一 步 的 改动 都 有 着 既定 的 目标 。 
Account 类 依然 是 重 构 的 目标 类 型 ， 不 过 这 次 它 有 了 一 个 新 的 CalculateRewardPoints 方 法 。 
与 很 多 公司 一 样 ,你 的 客户 也 希望 通过 积分 方式 给 忠实 的 用 户 回 馈 一 些 奖 励 , 在 满足 一 些 标 准 后 ， 
客户 可 以 获得 一 定 的 奖励 积分 。 代 码 清单 4-28 展 示 了 新 的 Account 类 。 


代码 清单 4-28 ”新 的 Account 类 在 账户 余额 的 基础 上 增加 了 奖励 积分 功能 


public class Account 























{ 
public Account(AccountType type) 
{ 
this.type = type; 
} 


public decimal Balance 
{ 

get; 

private set; 


} 
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public int RewardPoints 


{ 
get 
private set; 
} 
public void AddTransaction(decimal amount) 
{ 
RewardPoints += CalculateRewardPoints (amount); 
Balance += amount; 
} 


public int CalculateRewardPoints(decimal amount) 


{ 
int points; 
switch(type) 
{ 
case AccountType.Silver: 
points = (int)decimal.Floor(amount / 10); 
break ; 
Case AccountType.Gold: 
points = (int)decimal.Floor((Balance / 10000 * 5) + (amount / 5)); 
break; 
case AccountType.Platinum: 
points = (int)decimal.Ceiling((Balance / 10000 * 10) + (amount / 2)); 
break; 
default: 
points = 0; 
break ; 
} 
return Math.Max(points, 0); 
} 


private readonly AccountType type; 


下 面 列举 一 下 该 类 的 重要 修改 。 
口 增加 了 一 个 新 的 属性 ， 用 来 追踪 客户 账 尸 下 相关 的 奖励 积分 。 
口 每 个 账户 都 有 一 个 私有 的 类 型 数据 来 表明 该 账户 的 级 别 : 银 卡 、 金 卡 或 者 日 金 卡 。 
口 当 账户 上 发 生 交 易 时 ， 客 户 可 以 获得 一 定 的 奖励 积分 。 
口 获得 的 奖励 积分 的 额度 取决 于 计算 方法 中 使 用 的 以 下 几 个 因素 。 
a 账户 类 型 一 一 账户 级 别 越 高 ， 获 得 的 积分 越 多 。 
a 交易 额度 一 一 客户 消费 越 多 ， 获 得 的 积分 越 多 。 
a 账户 余额 一 一 金 卡 和 白金 卡 能 获得 更 多 积分 ， 以 工 励 客户 保持 较 高 的 账户 余额 。 
假设 这 些 代 码 和 相应 的 单元 测试 都 一 起 写 好 了 , 这 些 测试 能 更 好 地 保证 对 代码 的 修改 不 影响 
它们 声明 的 行为 。 这 一 点 非常 重要 : 重 构 只 改变 代码 的 布局 而 不 是 输出 。 如 果 你 尝试 在 没有 单元 
测试 的 情况 下 重 构 现 有 代码 , 你 又 如 何 保证 你 的 重 构 没有 破坏 期 望 的 行为 呢 ?” 你 将 无 法 快速 得 到 
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失败 的 提示 ， 而 只 能 在 后 期 运行 代码 时 发 现 问题 ， 比 如 测试 时 或 者 是 更 糟糕 的 情况 
1. 用 常量 替代 魔法 数 
第 一 个 重 构 很 简单 但 是 对 改善 代码 可 读 性 有 着 至 关 重 要 的 作用 。 示 例 中 的 Calculate- 
RewardPoints 方 法 中 包含 了 很 多 魔法 数 。 方 法 中 使 用 了 六 个 不 同 的 数字 ， 而 且 没 有 它们 的 任何 
上 下 文 信息 ， 比 如 它们 是 什么 以 及 为 什么 需要 它们 等 。 编 写 这 些 代 码 的 人 知道 这 些 数字 的 意义 ， 
但 是 这 也 只 可 能 维持 一 到 两 周 , 更 长 时 间 后 ,他 们 也 会 忘记 数字 5 或 数字 2 的 原始 意义 了 。 代码 清 
单 4-29 展 示 了 重 构 后 的 代码 。 


代码 清单 4-29 ” 重 构 后 的 代码 对 不 熟悉 代码 的 人 来 说 可 读 性 更 高 


public class Account 





部 署 后 。 

















{ 
public int CalculateRewardPoints(decimal amount) 
{ 
int points; 
switch(type) 
{ 


case AccountType.Silver: 
points = (int)decimal.Floor(amount / SilverTransactionCostPerPoint); 
break; 
case AccountType.Gold: 
points = (int)decimal.Floor((Balance / ColdBalanceCostPerPoint) + (amount/ 
GoldTransactionCostPerPoint)); 
break; 
case AccountType.Platinum: 
points = (int)decimal.Ceiling((Balance / PlatinumBalanceCostPerPoint) + 
(amount / PlatinumTransactionCostPerPoint)); 
break; 
default: 
points = 0; 
break ; 
} 
return Math.Max(points, 0); 
} 


private const int SilverTransactionCostPerPoint = 10; 
private const int GoldTransactionCostPerPoint = 5; 
private const int PlatinumTransactionCostPerPoint = 2; 


private const int GoldBalanceCostPerPoint = 2000; 
private const int PlatinumBalanceCostPerPoint = 1000; 


所 有 魔法 数 都 被 相应 的 常量 蔡 代 。 其 中 三 个 常量 是 与 三 个 账户 类 型 下 每 个 积分 需要 的 交易 和 额 
度 有 关 ， 为 外 两 个 是 与 金 卡 以 及 白金 卡 下 每 个 积分 需要 的 账户 余额 数值 有 关 。 

这 个 重 构 的 好 处 就 是 不 熟悉 代码 的 人 也 能 很 容易 理解 代码 的 含义 了 , 因为 这 些 魔法 数 有 了 相 
应 的 自 描述 变量 名 。 只 用 没有 意义 的 变量 名 A、B 或 X 来 蔡 代 魔法 数 起 不 到 任何 改进 可 读 性 的 作用 。 
因此 要 尽量 选择 能 够 精确 表达 意图 的 变量 名 ,而 且 不 要 怕 名 称 太 长 。 要 抓 住 每 个 给 变量 、 类 和 方 
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法 命名 的 机 会 来 让 代码 变 得 具有 自 描 述 的 能 力 。 

2. 用 多 形 性 替代 条 件 表达 式 

接 下 来 的 这 个 重 构 更 加 复杂 一 些 。 CalculateRewards 方 法 内 的 switch 语 句 会 根据 账户 类 型 
切换 不 同 的 计算 积分 的 算法 ， 从 两 方面 来 看 这 都 会 产生 问题 。 第 一 ， 它 会 影响 代码 的 可 该 性 ,更 
重要 的 是 , 它 还 会 引入 更 多 的 维护 负担 。 不 难 想象 , 不 久 的 将 来 很 有 可 能 出 现 一 个 新 的 账户 类 型 。 
假设 很 多 人 都 满足 不 了 银 卡 的 要 求 ,所 以 你 需要 引入 一 个 新 的 类 型 : 青铜 卡 。 为 了 增加 这 个 新 的 
青铜 卡 类 型 ， 你 需要 更 改 现 有 的 Account 类 代码 并 进行 相关 测试 。 如 果 代 码 验 证 完成 并 且 已 经 部 
署 ， 应 该 尽量 避免 修改 它们 。 相 反 ,， 应 该 尝试 其 他 方式 来 扩展 代码 ， 以 达到 不 改变 现 有 代码 的 前 
提 下 满足 新 的 需求 变更 。 

这 里 的 目标 就 是 能 更 容易 地 增加 一 个 新 的 账户 类 型 日 能 改善 代码 的 可 读 性 。 为 此 ， 你 需要 
首 助 多 形 性 的 强大 能 力 。 你 需要 对 各 种 类 型 的 账户 建 模 并 继承 自 Account 类 。 金 卡 账 户 类 型 就 
有 了 自己 的 GoldAccount 类 定义 ， 同样， 也 有 银 卡 的 Si1verAccount 类 和 日 金 卡 的 Platinum- 
Account 类 。 

第 一 步 先 定义 这 些 具体 的 账户 类 型 ， 如 代码 清单 4-30 所 示 。 


代码 清单 4-30 ”每 个 账户 类 型 现在 部 有 自己 的 类 定义 


public class SilverAccount 

















{ 
public int CalculateRewardPoints(decimal amount) 
{ 
return Math.Max((int)decimal.Floor(amount / SilverTransactionCostPerPoint), 0); 
} 
private const int SilverTransactionCostPerPoint = 10; 
} 
AR 
public class GoldAccount 
{ 
public decimal Balance 
{ 
get 
set; 
} 


public int CalculateRewardPoints(decimal amount) 
{ 
return Math.Max((int)decimal.Floor((Balance / GoldBalanceCostPerPoint) + (amount / 
GoldTransactionCostPerPoint)), 0); 
} 


private const int GoldTransactionCostPerPoint = 5; 
private const int GoldBalanceCostPerPoint = 2000; 
} 
OA 


public class PlatinumAccount 
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{ 
public decimal Balance 
{ 
get; 
set; 
} 


public int CalculateRewardPoints(decimal amount) 
{ 
return Math.Max((int)decimal.Ceiling((Balance / PlatinumBalanceCostPerPoint) + 
(amount / PlatinumTransactionCostPerPoint)), 0); 


} 


private const int PlatinumTransactionCostPerPoint = 2; 
private const int PlatinumBalanceCostPerPoint = 1000; 


， 到 这 一 步 ， 原 有 的 Account 类 还 没有 变 ， 这些 具体 的 账户 类 型 都 是 独立 的 。 相 应 地 
这 些 En 试 都 会 复制 上 面 对 于 CalculateRewardPoints 方 法 的 期 望 ， 只 是 每 个 账户 类 
型 的 测试 目标 系统 不 一 样 。 
白金 卡 和 金 卡 类 型 的 奖励 积分 算法 也 与 账户 当前 余额 有 关 ， 上 面 示 例 的 代码 也 显示 了 这 一 
点 ， 因 此 这 些 类 型 都 可 以 单独 进行 编译 。Balance 属 性 现在 可 以 公开 设置 了 ， 这 样 单元 测试 也 会 
与 前 面 的 不 一 样 。 图 4-8 中 的 UML 类 图 展示 了 这 些 类 之 间 的 关联 。 


<<ABSTRACT> > 
Account 


+Balance 
+RewardPoints 


+AddTransaction 
+CalculateRewardPoints 





SilverAccount GoldAccount PlatinumAccount 





+CalculateRewardPoints +CalculateRewardPoints +CalculateRewardPoints 


图 4-8 ”因为 有 CalculateRewardPoints 这 个 抽象 方法 ，Account 也 变 成 了 抽象 类 


- 步 是 实现 完整 替换 switch 语 句 目标 过 程 中 的 一 个 小 目标 。 每 次 不 要 做 太 多 也 很 重要 ， 
因为 只 有 这 样 你 才能 够 确保 上 自己 的 每 个 小 改动 是 成 功 的 。 下 一 步 要 做 的 改动 是 把 四 个 类 型 组 织 到 
一 个 继承 层级 结构 下 ， 如 代码 清单 4-31 所 示 。 
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代码 清单 4-31 Account 类 中 最 复杂 的 部 分 已 经 被 移 除 了 


public abstract class AccountBase 


{ 
public decimal Balance 
{ 
get; 
private set; 
} 
public int RewardPoints 
{ 
get; 
private set; 
} 
public void AddTransaction(decimal amount) 
{ 
RewardPoints += CalculateRewardPoints (amount); 
Balance += amount ; 
} 
public abstract int CalculateRewardPoints(decimal amount); 
} 


没有 了 switch 语 句 ，type 数 据 也 就 没有 必要 存在 了 ， 因 此 带 有 参数 的 构造 函数 也 不 需要 了 。 
抽 和 象 的 计算 方法 导致 这 个 类 也 要 变 成 抽象 的 , 这 就 意味 着 ， 你 不 能 实例 化 它 了 ， 当 然 也 不 能 再 直 
接 测试 它 了 。 

单元 测试 需要 一 个 对 象 实例 才 可 以 工作 , 因此 下 一 步 就 是 把 这 三 个 账户 类 型 作为 这 个 基 类 的 
子 类 。 给 抽象 类 命名 添加 后 级 Base 与 接口 命名 前 有 前 级 I 一 样 ， 都 是 很 有 用 的 命名 约定 。 从 后 级 
Base 上 可 以 直接 看 出 该 类 无 法 实例 化 且 有 关联 的 子 类 。 

现在 ,你 可 以 从 Go1dAccount 类 和 P1atinumAccount 类 中 移 除 Balance 属 性 了 , 因为 它们 可 
以 直接 继承 基 类 的 Balance 属 性 和 AddTransaction 方 法 成 员 。 代 码 清单 4-32 展 示 了 这 次 重 构 后 
的 代码 。 


代码 清单 4-32 完成 继承 基 类 重 构 后 的 代码 


public class SilverAccount : AccountBase 








{ 
public override int CalculateRewardPoints(decimal amount) 
{ 
return Math.Max((int)decimal.Floor(amount / SilverTransactionCostPerPoint), 0); 
} 
private const int SilverTransactionCostPerPoint = 10; 
} 
/ee 


public class GoldAccount : AccountBase 


{ 
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public override int CalculateRewardPoints(decimal amount) 
{ 
return Math.Max((int)decimal.Floor((Balance / GoldBalanceCostPerPoint) + (amount / 
GoldTransactionCostPerPoint)), 0); 
} 


private const int GoldTransactionCostPerPoint = 5; 
private const int GoldBalanceCostPerPoint = 2000; 
} 
7 


public class PlatinumAccount : AccountBase 


{ 


public override int CalculateRewardPoints(decimal amount) 
{ 
return Math.Max((int)decimal.Ceiling((Balance / PlatinumBalanceCostPerPoint) + 
(amount / PlatinumTransactionCostPerPoint)), 0); 


} 


private const int PlatinumTransactionCostPerPoint = 2; 
private const int PlatinumBalanceCostPerPoint = 1000; 


至 此 ,这 个 重 构 就 完成 了 。 从 此 开始 ,为 支持 新 增加 的 账户 类 型 只 需要 创建 一 个 新 的 Account- 
Base 类 的 子 类 并 提供 自己 的 CalculateRewardPoints 方 法 实现 即 可 。 无 需 改 变 任 何 已 有 代码 ， 
你 需要 做 的 只 是 针对 新 的 奖励 积分 算法 再 编写 一 些 单元 测试 。 

3. 用 工厂 方法 替代 构造 函数 

在 改善 Account 类 的 过 程 中 ,你 会 发 现 上 面 的 几 个 重 构 会 给 其 他 一 些 地 方 市 来 副作用 。 重 构 
前 , 使 用 该 类 的 客户 端 使 用 Account 类 的 高 有 账户 类 型 参数 的 构造 函数 来 创建 账户 对 象 , 重 构 后 ， 
客户 端 又 如 何 创建 想 要 的 账户 子 类 对 象 呢 ? 

AccountType 枚 举 可 以 用 作 AccountBase 类 的 工厂 方法 的 参数 。 尺 管 构造 函数 和 new 运 算 符 
一 起 使 用 可 以 返回 该 类 的 实例 对 象 , 而 工厂 方法 能 返回 同一 个 继承 层次 结构 下 的 很 多 种 不 同类 型 
的 对 象 。 代 码 清单 4-33 展 示 了 基 类 中 实现 的 工厂 方法 。 


代码 清单 4-33 switch 语句 又 回来 了 ,但 是 更 加 简洁 了 


public abstract class AccountBase 


{ 

















public static AccountBase CreateAccount(AccountType type) 
{ 
AccountBase account = null; 
switch(type) 
{ 
case AccountType.Silver: 
account = new 911verAccount() ; 
break ; 
Case AccountType.Gold: 
account = new GoldAccount(); 
break; 
case AccountType.Platinum: 
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account = new PlatinumAccount(); 
break ; 
} 


return account; 


} 


工厂 方法 能 够 减轻 客户 端 代 码 的 负担 的 两 个 关键 点 是 : 第 一 , 它 是 静态 方法 ,这 就 意味 着 客 
户 端 可 以 直接 通过 类 调用 它 ， 而 不 需要 类 实例 ; 第 二 ,返回 类 是 基 类 ,这 样 做 可 以 对 客户 端 隐藏 
具体 的 子 类 账户 。 实 际 上 ， 将 子 类 声明 为 internal 就 可 以 确保 程序 集 外 不 可 见 。 这 样 客户 端 也 
无 法 直接 构造 子 类 的 实例 对 象 ， 也 就 消除 了 潜在 的 new 代 码 味道 。 代 码 清 单 4-34 比 较 了 重 构 前 后 
客户 端 和 账户 交互 的 方式 。 

尽管 仍然 有 switch 语 句 存在 , 但 它 变 得 更 简洁 了 ， 同 时 也 利用 到 了 前 面 多 形 性 重 构 的 好 处。 


代码 清单 4-34 AccountService 类 在 重 构 前 后 创建 新 账户 方式 的 比较 


public void CreateAccount(AccountType accountType) 

















{ 
var newAccount = new Account(accountType); 
accountRepository.NewAccount (newAccount); 

} 

0 

public void CreateAccount(AccountType accountType) 

{ 
var newAccount = AccountBase.CreateAccount(accountType); 
accountRepository.NewAccount (newAccount); 

} 


上 面 的 代码 示例 中 比较 了 客户 端 (这 里 是 指 AccountService 类 ) 在 重 构 前 后 创建 新 的 账户 
的 两 种 不 同 的 方式 。 代 码 区 别 并 不 大 ， 但 是 要 注意 到 new 运 算 符 已 经 被 静态 的 工厂 方法 替代 了 。 
这 种 方式 很 常见 , 它 用 适应 能 力 更 高 的 代码 替代 了 非 兹 具体 的 代码 。 与 总 是 返回 同一 类 实例 的 方 
法 相 比 ， 工 广 方法 提供 了 更 多 的 可 能 性 ， 因 为 它们 能 够 返回 同一 个 基 类 下 的 所 有 子 类 实例 。 

用 心 的 读者 可 能 会 发 现 静 态 工厂 方法 并 不 是 最 优 的 选择 ， 因 为 它 是 一 个 天 钧 而 不 是 一 个 塔 
吊 , 因此 会 影响 到 代码 的 可 测 性 和 适应 能 力 。 更 好 的 选择 应 该 是 将 CreateAccount 方 法 安排 在 一 
个 合适 的 接口 里 ， 下 一 节 会 详细 讲解 这 种 方法 。 

4 用 工厂 类 替代 构造 哨 数 

相对 于 工厂 方法 ， 更 好 的 一 种 选择 是 工厂 类 。 实际 上 , 你 不 需要 让 用 户 总 是 使 用 单个 工厂 方 
法 的 实现 ， 只 需要 给 他 们 一 个 接口 ， 如 代码 清单 4-35 所 示 。 


代码 清单 4-35 ”IAccountFactory 接 口 隐 藏 了 创建 账户 实例 的 实现 细节 


public interface IAccountFactory 


{ 














AccountBase CreateAccount (AccountType accountType); 


} 
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接口 的 方法 实际 上 与 工厂 方法 一 样 ， 只 是 它 是 个 实例 方法 。 接口 的 实现 可 以 与 前 面 静 态 工 ) 
方法 完全 一 样 ， 这 就 意味 着 该 实现 要 清楚 地 知道 所 有 不 同 的 账户 类 型 。 这 样 重 构 后 ，Account- 
Service 类 和 其 他 客户 端 都 需要 将 该 接口 作为 构造 函数 的 一 个 参数 ， 如 代 人 码 清单 4-36 所 示 。 


代码 清单 4-36 AccountService 类 使 用 构造 水 数 的 工厂 实例 参数 来 创建 账户 实例 


public class AccountService 


{ 


public AccountService(IAccountFactory accountFactory, IAccountRepository 
accountRepository) 
{ 
this.accountFactory = accountFactory; 
this.accountRepository = accountRepository; 


} 


public void CreateAccount(AccountType accountType) 


{ 
var newAccount = accountFactory.CreateAccount(accountType); 
accountRepository .NewAccount (newAccount); 


} 


private readonly IAccountRepository accountRepository; 
private readonly IAccountFactory accountFactory; 


} 


现在 这 个 AccountService 类 看 起 来 才 像 它 应 有 的 样子 了 : 通过 组 合 使 用 多 个 合适 粒度 的 接 
口 来 为 用 户 界 面 层 提供 更 大 的 目标 。 这 里 为 了 简短 和 明晰 , 在 构造 函数 中 上 略 去 了 一 些 防 止 出 现 空 
引用 的 防卫 语句 ， 以 及 在 CreateAccount 方 法 中 略 去 了 一 些 用 于 封装 域 异常 到 服务 异常 中 的 
try/catch 代 人 码 块 。 


4.2.2 一 个 新 的 账户 类 型 


此 时 ， 你 能 有 足够 的 信心 以 最 小 的 代码 改动 来 实现 新 账户 类 型 的 需求 吗 ? 这 个 还 是 说 不 准 。 
一 种 情况 下 ,你 可 以 小 心 颖 台 地 添加 新 的 账户 类 型 ， 但 妃 外 的 情况 下 ,你 会 发 现 现 有 的 模型 设计 
做 了 一 些 错误 的 假设 ， 这 些 错误 的 假设 就 形成 了 技术 债务 。 

1. 一 个 新 的 奖励 账户 

假设 你 的 客户 端 邵 想 要 增加 为 外 一 种 新 的 账户 类 型 : 青铜 卡 , 它 能 得 到 银 卡 账户 一 半 的 奖励 
积分 。 为 了 支持 这 个 新 类 型 只 需要 在 域 层 进行 两 处 改动 。 第 一 ,你 需要 基于 AccountBase 基 类 
创建 新 的 子 类 ， 如 代码 清单 4-37 所 示 。 


代码 清单 4-37 青铜 卡 账户 是 一 种 新 的 账户 类 型 


internal class BronzeAccount : AccountBase 


{ 











public override int CalculateRewardPoints(decimal amount) 


{ 
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return Math.Max((int)decimal.Floor(amount / BronzeTransactionCostPerPoint), 0); 


} 


private const int BronzeTransactionCostPerPoint = 20; 


这 个 简单 改变 包括 一 个 新 的 验证 你 的 期 望 的 单元 测试 , 以 及 一 个 新 的 包含 计算 奖励 积分 算法 
的 类 型 。 

无 论 是 工厂 类 还 是 工矿 方 法 ,为 了 文 持 新 的 账户 类 型 ， 你 都 需要 改变 它 ， 以 及 定义 可 能 账户 
类 型 的 枚 举 。 代 码 清 单 4-38 展 示 了 如 何 修改 工厂 类 来 文 持 新 的 青铜 卡 账 户 。 


代码 清单 4-38 在 switch 语 句 下 增加 的 新 case 是 用 来 创建 青铜 卡 账户 的 


public AccountBase CreateAccount (AccountType accountType) 











{ 
AccountBase account = null; 
switch (accountType) 
{ 
Case AccountType.Bronze: 
account = new BronzeAccount() ; 
break ; 
case AccountType.Silver: 
account = new SilverAccount(); 
break; 
case AccountType.Gold: 
account = new GoldAccount(); 
break; 
case AccountType.Platinum: 
account = new PlatinumAccount(); 
break ; 
} 
return account; 
} 





在 继续 支持 客户 端 需要 的 下 一 个 新 账户 类 型 之 前 ,你 是 否 还 能 对 该 方法 再 做 重 构 从 而 无 需 为 
每 个 新 增 类 型 修改 方法 代码 ? 你 不 可 以 再 使 用 在 “用 多 态 替 代 条 件 表达 式 ” 部 分 中 讲述 的 重 构 方 
法 了 ,因为 工厂 方法 就 是 这 种 重 构 的 结果 。 相 反 , 是 否 可 以 从 accountType 名 称 构造 AccountBase 
类 的 实例 且 无 需 直 接 引用 每 个 名 称 的 具体 值 和 子 类 ? 代码 清单 4-39 给 出 了 答案 。 


代码 清单 4-39 如果 所 有 账户 都 遭 守 一 个 确定 的 命名 规则 ， 这 个 工厂 就 足以 处 理 它 们 了 


public AccountBase CreateAccount(string accountType) 


{ 











var objectHandle = Activator.CreatelInstance(null, string.Format("{0}Account", 
accountType)); 
return (AccountBase)objectHandle.UnwrapQO; 
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注意 看 ， 这 里 采用 了 更 加 灵活 的 字符 串 值 来 代替 枚 举 值 。 这 也 许 会 引入 问题 ， 因 为 任何 字 
符 串 值 都 是 可 以 接受 的 ， 而 不 是 预先 定义 的 可 以 匹配 的 有 效 账 户 类 型 。 当 然 ， 这 也 是 当前 练习 
的 要 点 。 

这 种 重 构 有 一 点 激进 , 因为 它 存 在 创建 有 漏洞 的 工厂 抽象 的 风险 , 也 就 是 说 该 工厂 并 不 能 响 
应 所 有 的 请 求 。 应 用 这 种 重 构 需 要 先 满足 以 下 几 个 前 提 条 件 。 

口 每 个 账户 类 型 必须 遵守 命名 规则 [Type]Account， 前 级 [Type] 是 账户 类 型 的 枚 举 值 。 

口 每 个 账户 类 型 必须 与 该 工厂 方法 在 同一 个 程序 集中 。 

口 每 个 账户 类 型 必须 要 有 公共 的 默认 构造 函数 ( 这 种 类 型 无 法 使 用 任何 值 进行 参数 化 )。 

这 些 限制 条 件 通 常 意 味 着 重 构 有 些 过 度 了 , 如果 后 面 无 法 满足 其 中 某 个 条 件 , 这 种 重 构 就 会 
引入 问题 。 因 此 ， 请 谨慎 行事 。 

2. 代码 味道 ， 拒绝 继承 

在 发 起 新 的 积分 奖励 活动 后 的 某 一 天 , 客户 的 市 场 部 门 想 知 道 参 加 活动 的 每 种 账户 类 型 都 有 
多 少 用 户 。 你 告诉 他 们 整个 积分 奖励 活动 有 个 规则 : 单个 用 户 只 有 一 张 卡 , 只 能 是 青铜 卡 、 银 卡 、 
金 卡 或 白金 卡 中 的 一 种 。 但 是 实际 情况 并 不 是 这 样 的 。 因 为 没有 考虑 到 不 参与 积分 奖励 活动 的 账 
户 , 而 每 个 人 默认 拿 到 的 都 是 青铜 卡 。 这 样 分 析 后 的 结果 就 是 , 需要 支持 另外 一 种 新 的 账户 类 型 : 
标准 账户 。 

标准 账户 与 其 他 账户 的 目的 不 同 , 它 不 会 得 到 任何 积分 奖励 。 要 支持 这 个 新 的 账户 类 型 ， 有 
两 种 方法 可 以 选择 。 第 一 ， 你 可 以 创建 一 个 新 的 AccountBase 类 的 子 类 ， 如 代码 清单 4-40 所 示 ， 
其 中 的 CalculateRewardPoints 方 法 会 直接 返回 零 ， 用 来 直接 表达 并 不 累计 任何 积分 。 


代码 清单 4-40 ”一 种 不 计算 任何 积分 奖励 的 简单 账户 类 型 
internal class StandardAccount : AccountBase 


{ 





























public override int CalculateRewardPoints(decimal amount) 
{ 
return 0; 
} 
} 





另外 一 种 方式 就 是 承认 并 不 是 所 有 账户 都 可 以 得 到 奖励 积分 , 并 且 在 实际 的 域 模型 中 有 两 种 
不 同 的 类 型 。 在 这 种 情况 下 ， 不 要 为 CalculateRewardPoint 方 法 提供 默认 实现 ， 因 为 子 类 会 拒 
绝 继 承 父 类 的 现 有 实现 ， 这 也 是 著名 的 代码 味道 “拒绝 继承 ”。 代 码 清 单 4-40 的 示例 中 ， 
StandardAccount 类 直接 拒绝 实现 接口 的 方法 而 不 是 忽略 它 , 而 接 下 来 的 重 构 方式 将 会 拒绝 实现 
整个 接口 。 

3. 用 委托 替代 继承 

这 种 重 构 方式 需要 你 把 AccountBase 类 分 为 两 个 部 分 。 接 口 的 某 些 部 分 被 挪 到 一 个 新 的 类 型 
层次 结构 中 来 表示 积分 奖励 卡 ， 其 余 的 继续 留 在 AccountBase 类 中 。 这 种 方式 通过 委托 积分 奖励 
卡 来 蔡 代 账户 类 型 的 继承 关系 。 
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首先 要 做 的 改动 是 引入 新 的 IRewardCard 接 口 来 定义 积分 奖励 卡 的 属性 和 行为 , 如 代码 清单 
4-41 所 示 。 


代码 清单 4-41 积分 奖励 及 其 计算 方法 都 从 Account 类 中 移 走 了 


public interface IRewardCard 


{ 
int RewardPoints 
{ 
get 
} 
void CalculateRewardPoints(decimal transactionAmount, decimal accountBalance); 
} 


前 面 的 实例 中 , 这 两 个 成 员 都 属于 AccountBase 类 , 将 它们 移出 是 因为 它们 都 取决 于 是 否 存 
在 积分 奖励 卡 。 注 意 到 接口 中 的 CalculateRewardPoints 方 法 有 两 处 改动 。 第 一 处 ， 该 方法 不 
再 返回 任何 值 ， 因 为 它 希望 的 是 直接 修改 RewardPoints 属 性 。 第 二 ， 你 必须 给 该 方法 传人 账户 
余额 值 ， 因 为 TRewardCard 并 不 知道 账户 余额 。 这 也 是 以 这 种 方式 分 开 两 个 对 象 带 来 的 明显 副 作 
用 : 需要 处 理 所 有 积分 奖励 卡 中 并 没有 封装 的 上 下 文 数据 。 也 许 将 来 需要 改变 该 方法 的 签名 才 可 
以 消除 这 种 副作用 。 

代码 清单 4-42 展 示 了 重 构 后 的 青铜 卡 和 白金 卡 的 IRewardCard 接 口 的 实现 。 


代码 清单 4-42 ”积分 奖励 卡 实现 的 示例 


internal class BronzeRewardCard : IRewardCard 

















{ 
public int RewardPoints 
{ 
get ， 
private set; 
} 


public void CalculateRewardPoints(decimal transactionAmount, decimal accountBalance) 
{ 
RewardPoints += Math.Max((int)decimal.Floor(transactionAmount / 
BronzeTransactionCostPerPoint), 0); 
} 
private const int BronzeTransactionCostPerPoint = 20; 
} 
/0 
internal class PlatinumRewardCard : IRewardCard 
{ 
public int RewardPoints 
{ 
get ， 
private set; 
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public void CalculateRewardPoints(decimal transactionAmount, decimal accountBalance) 
{ 
RewardPoints += Math.Max((int)decimal.Ceiling((accountBalance / 
PlatinumBalanceCostPerPoint) + (transactionAmount / PlatinumTransactionCostPerPoint)), 0); 


} 


private const int PlatinumTransactionCostPerPoint = 2; 
private const int PlatinumBalanceCostPerPoint = 1000; 


这 些 类 与 它们 的 Account 类 前 身 很 类 似 ， 只 是 多 了 一 个 本 地 的 RewardPoints 属 性 。 
如 代码 清单 4-43 所 示 ，Account 类 不 再 是 抽象 的 ， 也 不 再 需要 有 Base 后 缀 了 了 。 多 造 实例 时 ， 
te 已 在 交易 发 生 时 计算 奖励 积分 。 整体 来 看 ,这 个 账 
类 型 很 像 无 需 处 理 积分 奖励 需求 时 候 的 初始 定义 。 


代码 清单 4-43 ”现在 每 个 账户 中 都 包含 了 一 个 积分 奖励 卡 


public class Account 














{ 
public Account(IRewardCard rewardCard) 
{ 
this.rewardCard = rewardCard; 
} 
public decimal Balance 
{ 
get, 
private set; 
} 
public void AddTransaction(decimal amount) 
{ 
rewardCard.CalculateRewardPoints(amount, Balance); 
Balance += amount; 
} 
private readonly IRewardCard rewardCard ; 
} 


为 了 支持 标准 账户 ( 没有 积分 奖励 卡 的 账户 )， 你 要 么 给 构造 函数 传人 积分 奖励 卡 的 nu113 引 1 
用 (并且 在 引用 前 增加 防卫 语句 来 避免 Nu11ReferenceException 异 常 )， 要么 你 直接 定义 一 个 
NullRewardCard。 后 者 也 是 应 用 空 对 象 模 式 的 一 种 实现 , 它 在 CalcaulateReardPoints 方 法 被 
调用 时 不 会 累计 任何 积分 奖励 。 





4.3 总 结 
本 章 是 单元 测试 和 重 构 的 混合 体 ， 因 为 这 二 者 总 是 同时 出 现 并 交替 应 用 的 。 
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每 个 单元 测试 都 应 该 表达 产品 代码 的 期 望 ,理想 情况 下 ， 一 个 外 行 应 该 能 理解 这 个 期 望 。 尽 
管 测试 和 代码 一 样 都 是 技术 工件 , 单元 测试 用 一 组 对 象 来 验证 对 真实 世界 期 望 的 行为 , 就 像 这 些 
对 象 封装 了 真实 世界 的 概念 一 样 。 

当 你 认真 应 用 测试 先行 的 方法 时 ， 你 首先 要 编写 的 是 一 个 失败 的 单元 测试 而 不 是 产品 代码 。 
然后 你 再 尝试 编写 最 简单 的 产品 代码 来 让 单元 测试 由 红色 失败 状态 转 为 绿色 成 功 状 态 。 按照 这 种 
逻辑 ， 产 品 代 码 就 成 为 了 实现 单元 测试 期 望 行 为 的 自然 产 出 物 。 

当 你 在 对 代码 做 单元 测试 时 , 就 为 自己 后 期 改动 产品 代码 以 使 其 具备 更 高 的 适应 需求 变更 能 
力 提 供 了 一 个 坚实 的 基础 。 对 代码 的 重 构 是 一 个 渐进 地 改善 已 有 代码 设计 的 过 程 。 具 体 的 重 构 方 
式 有 很 多 种 , 本 章 只 讲解 了 一 部 分 。 每 种 重 构 方 式 都 有 可 能 表示 对 某 个 域 的 折 中 以 对 另外 一 个 域 
做 出 一 定 的 改善 ， 而 且 重 构 过 程 与 编程 的 其 他 很 多 方面 一 样 ， 都 是 很 主观 的 。 

到 此 , 本 书 的 敏捷 基础 这 一 部 分 就 结束 了 。 接 下 来 的 第 二 部 分 将 会 集中 讲解 SOLID 代 码 以 及 
它 如 何 帮 助 你 提高 代码 的 自 适 应 能 力 。 




















编写 SOLID 代码 





单一 职 贡 原则 
开放 与 封闭 原则 
Liskov 替换 原则 
接口 分 离 原则 
依赖 注入 原则 


滤波 
OO 


轿 
滤波 
做 典 娠 媒 姓 


加 
波 
OO 





SOLID 是 一 组 最 佳 编码 实践 的 首 字 母 缩写 。 同 时 应 用 这 些 最 佳 实践 ， 能 提高 代码 适应 变更 
的 能 力 。 尽 管 Bob Martin 已 经 于 15 年 前 识别 并 引入 了 这 组 SOLID 实践 活动 ， 它 们 应 该 被 大 家 
熟知 ， 但 是 事实 上 它们 并 没有 得 到 广泛 传播 。 

这 一 部 分 中 ， 每 章 都 会 专门 讲解 一 个 SOLID 原则 。 

口 S 单一 职责 原则 

口 0 开放 与 封闭 原则 

口 L Liskorv 和 替换 原则 

口 工 接口 分 离 原 则 

口 D 依赖 注入 原则 
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即便 分 开讲 述 这 些 原则 ， 它 们 每 一 个 都 是 值得 所 有 软件 开发 人 员 认 真 学 习 的 。 如 果 配 合 使 
用 这 些 原则 ， 它 们 能 给 代码 带 来 完全 不 同 的 结构 ， 这 种 结构 具备 很 强 的 适应 变更 的 能 

尽管 如 此 ， 与 其 他 模式 和 实践 一 样 ， 它 们 也 只 是 工具 。 如 何 选 择 在 正确 的 时 机 和 场合 中 应 
用 模式 或 实践 本 身 就 是 软件 开发 艺术 的 一 部 分 。 过 度 使 用 虽然 可 以 让 代码 有 很 高 的 自 适 应 能 力 ， 
但 会 导致 层次 粒度 过 小 而 难以 理解 或 使 用 。 过 度 使 用 还 会 影响 到 代码 质量 的 另 一 个 关键 因素 : 
可 读 性 。 现 代 软 件 产 品 的 开发 已 不 再 是 一 个 人 单打 独 斗 ， 通常 都 是 由 一 个 团队 协作 完成 。 因 此 ， 
审慎 地 决定 模式 、 实 践 或 SOLID 原则 的 应 用 时 机 和 场合 是 非常 重要 的 ， 只 有 这 样 才 可 以 保证 代 
码 在 将 来 一 直 都 是 可 以 被 完全 理解 的 。 














完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 理解 单一 职责 原则 的 重要 性 。 

口 识别 出 职责 太 多 的 类 。 

口 编写 具有 单一 职责 的 方法 、 类 和 模块 。 

口 将 巨型 类 重 构 为 多 个 具有 单一 职责 的 小 型 类 。 

口 使 用 设计 模式 来 分 离职 责 。 

单一 职责 原则 ( Single Responsibility Principle，SPR ) 要 求 开 发 人 员 所 编写 的 代码 有 且 只 有 
一 个 变更 理由 。 如 果 一 个 类 有 多 个 变更 理由 , 那么 它 就 具有 多 个 职责 。 多 职责 类 应 该 被 分 解 为 多 
个 单 职 责 类 。 

本 章 会 讲解 如 何 创 建 有 用 的 单 职责 类 。 通过 委托 和 抽象 ,包含 多 个 变更 理由 的 类 应 该 把 一 个 
或 多 个 职责 委托 给 其 他 的 单 职责 类 。 

抽象 的 重要 性 再 强调 也 不 为 过 。 它 是 自 适应 代码 的 支撑 , 没有 它 ， 开 发 人 员 就 只 能 疲于奔命 
地 应 付 Scrum 和 其 他 敏捷 流程 积极 啊 应 的 变更 需求 了 。 


5.1 问题 描述 


为 了 更 好 地 讲解 拥有 太 多 职责 类 的 问题 ， 本 市 会 通过 一 个 示例 做 详细 的 训 析 。 代 码 清单 5-1 
展示 了 一 个 简单 的 交易 处 理 带 类 , 它 能 从 文件 读 取 记 录 并 更 新 数据 库 。 尽 管 它 现在 看 起 来 还 很 小 ， 
但 为 了 满足 一 些 需 求 ， 你 需要 在 此 基础 上 持续 添加 新 特性 。 


代码 清单 5-1 ”一 个 拥有 太 多 职责 类 的 示例 
public class TradeProcessor 
{ 


public void ProcessTrades(System.I1I0.Stream stream) 


{ 























// read rows 
var lines = new List<string>() ; 
using(var reader = new System.10.StreamReader(stream)) 
{ 
string line; 
while((line = reader.ReadLine()) != null) 
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lines.Add(line); 


} 
var trades = new List<TradeRecord> QO; 


var lineCount = 1; 
foreach(var line in lines) 
{ 
var fields = line.Split(new char[] { '," }); 


if(fields.Length != 3) 
{ 
Console.WriteLine("WARN: Line {0} malformed. Only {1} field(s) found.", 
lineCount, fields.Length); 
continue; 


} 


if(Cfields[0].Length != 6) 
{ 
Console.WriteLine("WARN: Trade currencies on line {0} malformed: '{1}'", 
lineCount, fields[0]); 
continue; 


} 


int tradeAmount; 
if(C!int.TryParse(fields[1], out tradeAmount)) 
{ 
Console.WriteLine("WARN: Trade amount on line {0} not a valid integer: 
'{1}'", lineCount, fields[1]); 
} 


decimal tradePrice; 
if (!decimal.TryParse(fields[2], out tradePrice)) 
{ 
Console.WriteLine("WARN: Trade price on line {0} not a valid decimal: 
'{1}'", lineCount, fields[2]1); 
} 


var sourceCurrencyCode = fields[0].Substring(0, 3); 
var destinationCurrencyCode = fields[0].Substring(3, 3); 


// calculate values 
var trade = new TradeRecord 


{ 
SourceCurrency = sourceCurrencyCode, 
DestinationCurrency = destinationCurrencyCode, 
Lots = tradeAmount / LotSize, 
Price = tradePrice 

be 


trades.Add(trade); 


lineCount++; 
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} 


using (var connection = new System.Data.SqlClient.SqlConnection("Data 
Source=(local);Initial Catalog=TradeDatabase;Integrated Security=True")) 


{ 
connection.OpenQO; 
using (var transaction = connection.BeginTransaction()) 
{ 
foreach(var trade in trades) 
{ 
var command = connection.CreateCommand(); 
command .Transaction = transaction; 
command.CommandType = System.Data.CommandType.StoredProcedure; 
command .CommandText = "dbo.insert_trade"; 
command.Parameters.AddWwithValue("@QsourceCurrency", trade. 
SourceCurrency); 


command.Parameters.AddwithValue("@destinationCurrency", trade. 
DestinationCurrency); 

command.Parameters.AddwithValue("@lots", trade.Lots); 

command.Parameters.AddwithValue("@price", trade.Price); 


command .ExecuteNonQueryQ; 


} 


transaction.Commit(); 


} 
connection.CloseQO; 


} 


Console.WriteLine("INFO: {0} trades processed", trades.Count); 
} 


private static float LotSize = 100000f; 
} 








这 不 仅仅 是 一 个 单个 类 拥有 太 多 职 只 责 的 示例 , 也 是 一 个 单一 方法 拥有 太 多 职责 的 示例 。 在 仔 
细 阅 读 代 码 后 ， 你 才能 知道 这 个 类 在 尝试 达成 以 下 目标 。 

(1) 从 一 个 Stream 参 数 中 读 出 每 行内 容 并 存放 到 一 个 字符 串 列 表 中 。 

(2) 解析 出 每 行内 容 中 的 一 组 数据 并 把 它们 存放 在 一 个 更 结构 化 的 TradeRecord 实 例 的 列 
表 中 。 

(3) 整个 分 析 过 程 中 包括 了 一 些 校 验 数 据 的 动作 和 将 日 志 输 出 到 控制 台 的 动作 。 

(4) 枚 举 每 个 TradeRecord 实 例 ， 并 调用 了 一 个 存储 子 流程 来 将 数据 存放 到 一 个 数据 库 中 。 

TradeProcessor 的 职责 包括 : 读 取 流 数据 ， 解 析 字 符 串 ， 验 证 数据 ， 记 录 日 志 ， 以 及 向 数 
据 库 插 和 人 数据 。 单 一 职责 原则 要 求 这 个 类 和 其 他 类 一 样 应 该 只 有 一 个 变更 理由 。 然 而 ， 
TradeProcessor 的 现状 则 是 会 在 以 下 场合 都 会 发 生变 更 。 

口 当 你 决定 用 远程 Web 服 务 来 代替 Stream 作 为 输入 源 时 。 

口 当 输 入 数据 的 格式 变化 时 ， 也 许 会 增加 一 个 新 的 数据 项 来 表示 交易 的 代理 人 。 

口 当 输 入 数据 的 验证 规则 发 生变 化 时 。 
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口 当 你 输出 警告 、 错 误 和 信息 日 志 的 方式 改变 时 。 输出 给 控制 台 的 方式 对 远程 Web 服 务 来 说 
是 不 可 行 的 。 
口 当 数 据 库 也 发 生 了 某 些 变 化 时 ,也 许 是 insert_trade 存 储 过 程 也 需要 一 个 额外 的 代理 人 
参数 ， 或 者 你 决定 使 用 文档 存储 来 代替 关系 型 数据 库 时 ， 又 或 者 将 数据 库 移 到 你 所 使 用 
的 Web 服 务 后 台 时 。 
这 些 改变 必然 需要 修改 该 类 的 实现 。 更 进一步 说 ,除非 你 维护 了 很 多 种 版 本 ,否则 你 不 可 能 
让 TradeProcessor 能 够 同时 适 配 多 种 情况 ， 比 如 不 同 的 数据 输入 源 。 想 象 一 下 ， 在 只 有 几 个 命 
令 行 参数 的 情况 下 ， 如 果 要 求 将 交易 数据 存储 在 Web 服 务 上 ， 你 会 有 多 头疼 啊 。 


5.1.1 重 构 清晰 度 


将 TradeProcessor 重 构 为 单 职责 类 的 第 一 步 就 是 把 ProcessTrades 方 法 拆 分 为 多 个 更 小 的 
方法 ， 每 个 方法 专注 完成 一 个 职责 。 重 构 产 生 的 每 个 方法 都 会 在 接 下 来 的 代码 清单 中 进行 展示 ， 
代码 清单 后 还 会 讲解 改动 的 细节 。 

代码 清单 $S-2 展 示 了 重 构 后 的 ProcessTrades 方 法 ， 它 现在 只 是 委托 其 他 几 个 方法 做 事 。 
代码 清单 5-2 ”因为 将 工作 委托 给 了 其 他 方法 ， 所 以 ProcessTrades 方 法 现在 最 小 


public void ProcessTrades(System.IO.Stream stream) 














{ 
var lines = ReadTradeData(Cstream) ; 
var trades = ParseTrades(lines); 
StoreTrades (trades); 

} 





原始 的 ProcessTrades 方 法 代码 可 以 分 为 三 个 部 分 : 从 流 中 读 取 交易 数据 , 将 字符 串 数据 转 
换 为 TradeRecord 实 例 ， 以 及 将 交易 数据 写 和 人 永久 存储 中 。 注意 , 方法 的 输出 会 成 为 下 一 个 方法 
的 输入 。 如 果 没 有 从 ParseTrades 方 法 中 返回 的 交易 记录 数据 ,你 就 无 法 调用 StoreTrades 方 法 ， 
同样 ， 直 到 ReadTradeData 方 法 返回 字符 串 后 ， 你 才 可 以 调用 ParseTrades 方 法 。 

按照 顺序 ， 我 们 先 看 看 ReadTradeData 方 法 ， 如 代码 清单 5-3 所 示 。 


代码 清单 5-3 ReadTradeData 封 装 了 原 有 的 代码 


private IEnumerable<string> ReadTradeData(System.I0.Stream stream) 


{ 





var tradeData = new List<string>() ; 
using (var reader = new System.I10.StreamReader(stream)) 
{ 

string line; 

while ((line = reader.ReadLineG) != null) 

{ 

tradeData.Add(line); 

} 

} 


return tradeData; 
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这 个 方法 里 面 的 代码 直接 从 原 有 的 ProcessTrades 方 法 中 提取 。, 经 过 简单 的 封装 后 , 它 用 一 
个 字符 串 枚 举 返 回 了 该 取 到 的 所 有 字符 串 数 据 。 注 意 ， 此 处 与 原始 代码 是 有 所 不 同 的 , 返回 的 字 
符 串 枚 举 是 只 读 的 ， 而 原 有 实现 中 却 无 法 阻止 后 续 代 码 添 加 更 多 的 字符 串 。 

接 下 来 的 代码 清单 $-4 展 示 的 是 ParseTrades 方 法 。 它 的 代码 与 原 有 实现 不 完全 相同 ， 因 为 
它 自 己 也 要 委托 一 些 任务 给 其 他 方法 。 


代码 清单 5-4 ParseTrades 通 过 委托 其 他 方法 来 减 小 自己 代码 的 复杂 度 


private IEnumerable<TradeRecord> ParseTrades(IEnumerable<string> tradeData) 














{ 
var trades = new List<TradeRecord>() ; 
var lineCount = 1; 
foreach (var line in tradeData) 
{ 
var fields = line.Split(new char[] { ， }); 
if(!ValidateTradeData(fields, lineCount)) 
{ 
continue; 
} 
var trade = MapTradeDataToTradeRecord(fields); 
trades .Add (trade); 
lineCount++; 
} 
return trades; 
} 


该 方法 把 数据 校 验 和 映射 这 两 个 职责 委托 给 了 其 他 两 个 方法 。 如 果 不 做 这 种 委托 ,这 部 分 的 
处 理 逻 辑 依然 会 因 带 有 太 多 职责 从 而 太 过 复杂 。 代 码 清单 $-$ 会 展示 ValidateTradeData 方 法 ， 
它 返回 一 个 布尔 值 来 表明 交易 记录 数据 是 否 有 效 。 


代码 清单 5-5 ”所 有 的 校 验 代码 都 在 这 一 个 方法 内 


private bool ValidateTradeData(string[] fields, int currentLine) 


{ 














if (fields.Length != 3) 
{ 
LogMessage("WARN: Line {0} malformed. Only {1} field(s) found.", currentLine, 
fields.Length); 
return false; 


} 
if (fields[0].Length != 6) 
{ 
LogMessage("WARN: Trade currencies on line {0} malformed: '{1}'", currentLine, 
fields[0]); 


return false; 
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int tradeAmount; 
if (!int.TryParse(fields[1], out tradeAmount)) 
{ 
LogMessage("WARN: Trade amount on line {0} not a valid integer: '{]1l}"'", 
currentLine, fields[1]); 
return false; 


} 


decimal tradePrice; 
if (!decimal.TryParse(fields[2], out tradePrice)) 
{ 
LogMessage("WARN: Trade price on line {0} not a valid decimal: '{]1l}"'", 
currentLine, fields[2]); 
return false; 


} 


return true; 











相对 于 原始 代码 ， 唯 一 的 改动 就 是 委托 另外 一 个 方法 来 记录 日 志 。 代 码 清单 5-6 展 示 了 这 个 
改动 ， 使 用 LogMessage 方 法 而 不 是 直接 调用 Console.WriteLine。 


代码 清单 5-6 LogMessage 方 法 只 相当 于 给 Console.WriteLine 起 了 一 个 别名 


private void LogMessage(Cstring message, params object[] args) 
{ 
Console.WriteLine(message, args); 


} 


代码 清单 5-7 展 示 了 ParseTrades 方 法 委托 的 男 外 一 个 方法 。 它 将 一 组 从 流 中 读 取 到 的 字符 
串 映射 为 一 组 TradeRecord 类 的 实例 。 


代码 清单 5-7 ”从 一 个 类 型 映射 到 另外 一 个 类 型 是 一 个 独立 的 职责 


private TradeRecord MapTradeDataToTradeRecord(string[] fields) 
{ 
var sourceCurrencyCode = fields[0].Substring(0, 3); 
var destinationCurrencyCode = fields[0].Substring(3, 3); 
var tradeAmount = i1int.Parse(fields[1]); 
var tradePrice = decimal.Parse(fields[2]); 


var tradeRecord = new TradeRecord 


{ 
SourceCurrency = sourceCurrencyCode, 
DestinationCurrency = destinationCurrencyCode, 
Lots = tradeAmount / LotSize, 
Price = tradePrice 

bs 


return tradeRecord; 
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重 构 生成 的 第 六 个 也 是 最 后 一 个 方法 是 StoreTrades， 如 代码 清单 5-8 所 示 。 这 个 方法 封装 
了 与 数据 库 交 互 的 代码 。 它 也 委托 了 前 面 讲 到 的 LogMessage 方 法 来 记录 信息 日 志 。 
代码 清单 5-8 在 最 后 的 StoreTrades 方 法 就 绪 后 ， 该 类 的 各 个 职责 已 经 清楚 地 划分 开 了 


private void StoreTrades(IEnumerable<TradeRecord> trades) 


{ 








using (var connection = new System.Data.SqlClient.SqlConnection("Data 
Source=(local);Initial Catalog=TradeDatabase;Integrated Security=True")) 
{ 
connection.OpenQO; 
using (var transaction = connection.BeginTransaction()) 
{ 
foreach (var trade in trades) 
{ 
var command = connection.CreateCommand(); 
command.Transaction = transaction; 
command.CommandType = System.Data.CommandType.StoredProcedure; 
command .CommandText = "dbo.insert_ trade"; 
command.Parameters.AddwithValue("@QsourceCurrency", trade.SourceCurrency); 
command.Parameters.AddwithValue("@destinationCurrency", 
trade.DestinationCurrency); 
command.Parameters.AddwithValue("Q@lots", trade.Lots); 
command.Parameters.AddwithValue("@Qprice", trade.Price); 


command .ExecuteNonQueryQ; 


} 


transaction.Commit() ; 


} 


connection.Close(); 


} 


LogMessage("INFO: {0} trades processed", trades.Count()); 











回顾 一 下 刚刚 完成 的 重 构 ， 相 对 于 原 有 的 实现 而 言 已 经 有 了 明显 的 改进 。 然 而 ,你 真 的 得 到 
什么 了 吗 ? 尽管 新 的 ProcessTrades 方 法 比 原 来 的 巨型 方法 小 了 很 多 ， 代 码 也 更 加 容易 阅读 了 ， 
但 是 你 并 没有 将 代码 的 自 适 应 能 力 提 高 多 少 。 比 如 ， 你 现在 能 改动 LogMessage 方 法 的 实现 ， 用 
文件 蔡 代 控制 台 作 为 日 志 输 出 的 但 这 会 涉及 你 不 想 看 到 的 对 TradeProcessor 类 的 改动 。 

以 上 重 构 为 最 终 实现 划分 该 类 职责 的 目标 商定 了 坚实 的 基础 。 此 次 重 构 的 目标 是 清晰 度 ， 而 
不 是 自 适 应 能 力 。 接 下 来 的 任务 就 是 将 每 个 职责 划分 到 不 同 的 类 中 , 并 把 它们 隐藏 在 相应 的 接口 
后 面 。 现 在 你 需要 做 真正 的 抽象 ， 因 为 这 样 才能 真正 提高 代码 的 目 适 应 能 


5.1.2 ” 重 构 抽象 


构建 于 新 的 TradeProcessor 实 现 之 上 ， 接 下 来 的 重 构 会 引入 多 个 新 的 抽象 ， 它 们 几乎 能 满 
足 该 类 上 所 有 的 变更 请 求 。 尽 管 这 个 示例 看 起 来 似乎 很 小 , 甚至 微不足道 , 但 对 于 当前 这 个 主题 
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的 教程 来 说 它 仍 是 一 个 很 合适 的 范例 。 应 用 程序 规模 从 小 到 大 逐步 发 展 的 情况 也 很 普遍 。 再 小 的 
程序 ， 只 要 有 一 些 人 开始 使 用 ， 新 的 特性 需求 就 会 蜂拥 而 至 。 

通常 ， 术 语 原 型 (prototype ) 和 概念 验证 (proofof concept ) 会 用 于 描述 这 种 小 的 应 用 程序 ， 
而 从 原型 到 产品 应 用 程序 的 转变 几乎 是 无 颖 的 。 这 也 是 为 什么 重 构 抽 和 象 的 能 力 能 够 作为 自 适 应 开 
发 检验 标准 的 原因 。 如 果 不 做 抽象 重 构 , 大 量 的 只 带 有 模糊 职责 和 抽象 定义 的 需求 就 会 发 展 成 为 
一 个 “大 泥 球 ”: 一 个 包含 一 个 或 一 组 类 的 程序 集 。 最 终 得 到 的 应 用 程序 没有 相应 的 单元 测试 ， 
又 很 难 维护 和 增强 ， 而 它 还 可 能 是 业务 链 上 一 个 很 重要 的 节点 。 

重 构 TradeProcessor 抽 象 的 第 一 步 就 是 设计 一 个 或 一 组 接口 来 执行 三 个 最 高 级 别 的 任务 : 
读 取 数据 ， 人 处理 数据 和 存储 数据 。 图 5-1 展 示 了 第 一 组 抽象 。 


<<INTERFACE>> 
ITradeDatapProvider 





+GetTradeData() :IEnumerable<string> 


<<|INTERFACE> > 


-tradeDataProvider ITradeParser 


-tradeParser +Parse(IEnumerable<string>) :IEnumerable<TradeRecord> 
-tradeStorage 





+Persist(IEnumerable<TradeRecord>) :void 


图 5-1 TradeProcessor 将 会 依赖 三 个 新 的 接口 


基于 上 一 节 重 构 分 割 ProcessTrades 方 法 代码 形成 的 三 个 方法 ,你 应 该 清楚 如 何 开始 第 一 组 
抽象 。 根据 单一 职责 原则 的 定义 ,这 三 个 主要 的 职责 应 该 由 不 同 的 类 来 负责 。 此 外 ， 前面 几 章 也 
提 到 过 ,你 不 应 该 让 一 个 类 直接 依赖 其 他 类 ， 而 应 该 通过 接口 。 因 此 ,这 三 个 主要 职责 会 被 提取 
到 三 个 独立 的 接口 中 。 代 码 清 单 5-9 展 示 了 这 样 重 构 后 的 TradeProcessor 类 。 


代码 清单 5-9 现在 TradeProcessor 只 是 简单 地 封装 了 一 个 流程 


public class TradeProcessor 


{ 





public TradeProcessor(ITradeDataProvider tradeDataProvider, ITradeParser tradeParser, 
ITradeStorage tradeStorage) 


{ 
this.tradeDataProvider = tradeDataProvider; 
this.tradeParser = tradeParser; 
this.tradeStorage = tradeStorage; 

} 


public void ProcessTrades() 


{ 


var lines = tradeDataProvider.GetTradeData(); 


var trades = tradeParser.Parse(lines); 
tradeStorage.Persist(trades); 


} 


private readonly ITradeDataProvider tradeDataProvider; 
private readonly ITradeParser tradeParser; 
private readonly ITradeStorage tradeStorage; 


} 


现在 TradeProcessor 类 已 经 与 原始 的 实现 有 了 天 壤 之 别 。 它 现在 不 包括 任何 交易 处 理 流程 
的 细 市 实现 ， 取而代之 的 是 整个 流程 的 蓝图 。 这 个 类 现在 只 对 交易 数据 格式 转换 的 流程 建 模 ， 这 
是 它 的 唯一 职责 ,也 是 引起 该 类 后 续 变 更 的 唯一 原因 。 如 果 流 程 本 身 发 生 改 变 , 该 类 也 需要 改变 
以 反映 更 新 后 的 流程 。 你 如 果 只 是 打算 不 接受 流 数 据 , 不 再 将 日 志 输 出 到 控制 台 , 或 者 不 再 将 交 
易 数 据 存储 到 数据 库 中 ， 这 些 都 不 会 影响 TradeProcessor 类 。 

根据 阶梯 模式 (在 第 2 章 中 介绍 过 ) 的 定义 , TradeProcessor 类 依赖 的 所 有 接口 都 应 该 在 各 
自 独 立 的 程序 集 内 。 这 样 就 保证 了 TradeProcessor 类 的 客户 端 或 接口 的 实现 程序 集 之 间 没 有 相 
互 依赖 。 三 个 接口 的 实现 类 StreamTradeDatapProvider、Simp1eTradeParser 和 AdoNetTrade- 
Storage 可 以 分 布 在 三 个 不 同 的 程序 集中 。 这 三 个 类 型 有 个 共同 的 命名 约定 : 用 实现 所 需 的 具体 
上 下 文 信息 代替 了 接口 名 称 的 前 缀 I。 因此 StreamTradeProvider 顾 名 思 义 就 是 从 Stream 获 取 数 
据 的 ITradeProvider 接 口 的 一 个 实现 ; AdoNetTradeStorage 类 就 是 指使 用 ADO.NET 将 交易 数 
据 存 储 到 ITradeStorage 接 口 的 一 个 实现 ; 而 SimpleTradeParser 类 名 中 的 Simple 则 表示 该 类 
没有 其 他 上 下 文 的 依赖 关系 。 

这 三 个 实现 类 可 以 放置 在 同一 个 程序 集中 ， 因 为 它们 都 依赖 Microsoft .NET Framework 的 一 
组 核心 程序 集 。 如 果 要 引入 的 实现 依赖 的 是 第 三 方程 序 集 、 第 一 方程 序 集 或 者 非 核心 的 .NET 
Framework 程 序 集 ， 你 就 应 该 把 它们 布置 在 各 自 独 立 的 程序 集中 。 比 如 ， 你 打算 用 Dapper 映 射 库 
替代 ADO.NET， 你 会 创建 一 个 名 为 Services.Dapper 的 新 程序 集 ， 其 中 包含 了 ITradeStorage 
接口 的 实现 DapperTradeStorage 类 。 

ITradeDataProvider 接 口 并 不 依赖 Stream 类 。 而 上 一 节 中 用 来 获取 交易 数据 的 方法 需要 一 
个 Stream 实 例 作 为 传人 人 参数， 但 是 这 样 做 明显 会 让 该 方法 依赖 Stream 所 在 的 程序 集 。 当 你 在 创 
建 接口 并 做 抽象 重 构 时 , 不 要 保留 那些 会 对 代码 自 适 应 能 力 有 副作用 的 依赖 关系 , 这 一 点 很 重要 。 
我 们 已 经 知道 还 可 以 从 Stream 之 外 的 数据 源 获 取 交 易 数 据 ， 因 此 重 构 后 的 接口 已 经 不 包括 对 
Stream 的 依赖 了 。 取 而 代 之 的 是 ，StreamTradeProvider 类 需要 一 个 Stream 实 例 作 为 其 构造 也 
数 的 传人 参数 ， 而 不 是 成 员 方 法 的 传人 参数 。 通 过 使 用 构造 函数 ,你 可 以 建立 需要 的 任何 依赖 关 
系 ， 而 且 不 会 影响 接口 。 代 码 清单 5-10 展 示 了 StreamTradeProvider 的 实现 。 


代码 清单 5-10 ”可 以 通过 构造 函数 的 传 入 参数 将 上 下 文 传人 方法， 保持 接口 不 受 影 响 


public class StreamTradeDataProvider : ITradeDataProvider 


{ 


public StreamTradeDataProvider(Stream stream) 


{ 
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this.stream = stream; 


} 
public IEnumerable<string> GetTradeData() 
{ 
var tradeData = new List<string>() ; 
using (var reader = new StreamReader(Cstream) ) 
{ 
string line; 
while ((line = reader.ReadLineG) != null) 
{ 
tradeData.Add(line); 
} 
} 
return tradeData; 
} 


private Stream stream; 


记 住 , 作为 客户 端的 TradeProcessor 类 现在 不 清楚 , 当然 也 不 应 该 清楚 StreamTradeData- 
Provider 类 的 任何 实现 细节 ， 现 在 它 只 能 通过 ITradeDataProvider 接 口 的 GetTradeData 方 法 
来 获取 数据 。 

TradeProcessor 类 这 个 示例 还 可 以 提取 更 多 的 抽象 。 比 如 原 有 的 ParseTrades 方 法 被 委托 
承担 数据 校 验 和 类 型 映射 的 职责 ， 你 可 以 通过 重复 重 构 来 实现 只 具备 单一 职责 的 Simp1eTrade- 
Parser 类 。 图 5-2 展 示 了 重 构 得 到 的 SimpleTradeParser 类 的 UML 图 。 








<<INTERFACE> > 
ITradeParser 


+Parse() :IEnumerable<Trade Record> 


SimpleTradeParser <<INTERFACE> > 


- ITradeMapper 
-tradeValidator 


-tradeMapper +Map(string[]) :TradeRecord 


<<INTERFACE> > 
ITradeValidator 


+Validate(string[{]) : bool 








图 5-2 重 构 SimpleTradeParser 类 后 产生 的 新 类 也 只 具备 单一 职责 


将 职责 抽象 成 为 接口 (以 及 相应 的 实现 ) 的 过 程 是 递归 的 。 在 检视 每 个 类 时 ， 你 需要 判断 它 
是 否 具备 多 重 职责 ， 如 果 是 ， 提 取 职 责 的 抽象 直到 该 类 只 具备 单个 职责 。 代 码 清单 5-11 展 示 的 是 














5.1 问题 描述 137 





SimpleTradeParser 类 ， 它 同样 在 需要 的 时 候 委 托 其 他 接口 来 辅助 完成 自己 的 任务 。 对 于 它 而 
言 ， 唯 一 的 变更 缘由 就 是 交易 数据 整体 结构 的 改变 ， 比 如 ， 可 能 会 用 tab 替 代 到 号 来 分 隔 字 符 串 
数据 ， 或 者 用 XML 结构 来 代替 简单 结构 的 字符 串 。 

代码 清单 5-11 解析 交易 数据 的 算法 封装 在 ITradeParser 接 口 的 实现 当中 


public class SimpleTradeParser : ITradeParser 








{ 
public SimpleTradeParser(ITradeValidator tradeValidator, ITradeMapper tradeMapper) 
{ 
this.tradeValidator = tradeValidator; 
this.tradeMapper = tradeMapper; 
} 
public IEnumerable<TradeRecord> Parse(IEnumerable<string> tradeData) 
{ 
var trades = new List<TradeRecord>() ; 
var lineCount = 1; 
foreach (var line in tradeData) 
{ 
var fields = line.Split(new char[] { '," }); 
if (!tradeValidator.Validate(fields)) 
{ 
continue; 
} 
var trade = tradeMapper.Map(fields); 
trades .Add(trade); 
lineCount++; 
} 
return trades; 
} 
private readonly ITradeValidator tradeValidator; 
private readonly ITradeMapper tradeMapper ; 
} 





最 后 一 个 重 构 的 目标 是 将 日 志 功 能 的 抽象 从 两 个 使 用 它 的 类 中 提取 出 来 。 现 在 ITrade- 
Validator 和 ITradeStorage 两 个 接口 的 实现 过 程 中 都 会 直接 将 日 志 输 出 到 控制 人 台中。 这 次 重 
构 ， 你 不 需要 再 实现 自己 的 日 志 类 型 ， 而 是 创建 一 个 适 配 需 类 来 调用 流行 的 日 志 库 Log4Net。 图 
5-3 中 的 UML 图 展示 了 这 样 重 构 后 的 结 
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<<INTERFACE>> <<INTERFACE>> 
ITradeStorage ITradeValidator 


+Persist(IEnumerable<TradeRecord>) :void + Validate(stringD) : boo! 


AdoNetTradeStorage SimpleTradeValidator 


+Persist(IEnumerable<TradeRecord>) :void 


1 

1 
<<|NTERFACE> > 
lILogger 


+LogWarning() 
+Loglnfo() 
+LogError() 


Log4NetLoggerAdapter <<INTERFACE>> 
Log4Net.ILog 
-log 
+WarnFormat() 


+InfoFormat() 
+ErrorFormat!() 


+LogWarning!() 
+Loglnfo() 
+LogError() 


图 5-3 ”通过 为 Log4Net 实 现 一 个 适 配 带 ， 就 无 需 在 每 个 程序 集中 都 引用 它 了 


创建 诸如 Log4NetLoggerAdapter 等 适 配 需 类 的 好 处 是 , 你 可 以 通过 它们 把 第 三 方 引用 转换 
为 第 一 方 引 用 。 注 意 看 ，AdoNetTradeStorage 和 SimpleTradeValidator 两 个 类 都 依赖 第 一 方 
的 ILogger 接 口 , 但 在 运行 时 实际 调用 的 依然 是 Log4Net 的 程序 集 。 需 要 引用 Log4Net 程 序 集 的 地 
方 只 包括 应 用 程序 的 和 人口 ( 详 见 第 9 章 ) 以 及 新 创建 的 Service .Log4Net 程 序 集 。 这 样 ， 所 有 需 
要 依赖 Log4Net 的 代码 ， 比 如 定制 的 输出 带 等 ， 也 都 应 该 位 于 Service .Log4Net 程 序 集中 。 当 前 
示例 中 ， 目 前 只 有 适配器 类 的 实现 在 这 个 程序 集中 。 

代码 清单 5-12 展 示 了 重 构 后 的 数据 校 验 类 型 。 它 现在 不 再 依赖 控制 台 输 出 了 。 因 为 Log4Net 
的 灵活 实现 , 你 实际 可 以 在 任何 地 方 调用 记录 日 志 了 。 这 里 对 于 你 所 关心 的 日 志 问 题 ,代码 已 经 
达到 了 完全 上 自 适应 的 程度 。 


代码 清单 5-12 重 构 后 的 SimpleTradeValidator 类 


public class SimpleTradeValidator : ITradeValidator 
{ 




















private readonly ILogger logger:; 
public SimpleTradeValidator(ILogger logger) 
{ 
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this.logger = logger:; 
} 


public bool Validate(string[] tradeData) 
{ 
if (tradeData.Length != 3) 
{ 
logger .LogWarning("Line malformed. Only {1} field(s) found.", 
tradeData. Length); 
return false; 


} 

if (tradeData[0].Length != 6) 

{ 
logger .LogWarning("Trade currencies malformed: '{]1}'", tradeData[0]); 
return false; 

} 


int tradeAmount; 
if (!int.TryParse(tradeData[l1], out tradeAmount)) 
{ 





logger .LogWarning("Trade amount not a valid integer: '{]1l}'", tradeData[l1]); 
return false; 


} 


decimal tradePrice; 
if (!decimal.TryParse(tradeData[2], out tradePrice)) 
{ 
logger .LogWarning("WARN: Trade price not a valid decimal: '{]1l}"", 
tradeData[2]); 
return false; 


} 


return true; 





到 这 里 ， 我 们 需要 一 个 快速 的 回顾 。 请 记 住 ， 对 于 代码 的 功能 你 没有 做 任何 改动 ,代码 在 功 
能 上 和 原来 是 完全 一 样 的 。 尽 管 如 此 ， 如 果 你 就 是 想 要 增强 功能 ， 也 可 以 很 轻松 地 做 到 。 为 满足 
新 需求 而 给 代码 增加 新 功能 不 只 是 扩展 和 重 构 现 有 代码 ， 还 需要 增加 实现 新 功能 的 新 代码 。 

参考 前 面 已 经 列举 的 潜在 的 代码 增强 点 , 重 构 后 的 新 版 本 能 在 无 需 改变 任何 现 有 类 的 情况 下 
实现 以 下 需求 的 增强 功能 。 

口 需求 : 当 你 决定 用 远程 Web 服 务 来 代替 Stream 做 输入 源 时 。 

a 解决 方案 : 创建 一 个 ITradeDataProvider 接 口 的 新 实现 类 来 支持 从 服务 获取 数据 。 
口 需求 : 当 输 入 数据 的 格式 变化 时 ， 也 许 会 增加 了 一 个 新 的 数据 项 来 表示 交易 的 代理 人 。 
a 解决 方案 : 改变 ITradeDatavalidator、ITradeDataMapper 以 及 ITradeStorage 三 
个 接口 的 实现 以 支持 处 理 新 的 代理 人 数据 。 
口 需求 : 当 输 入 数据 的 验证 规则 变化 时 。 
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m 解决 方案 修改 ITradeDataValidator 接 口 的 实现 以 反映 最 新 的 规则 。 
口 需求 : 当 你 输出 警告 、 错 误 和 信息 日 志 的 方式 改变 时 。 输 出 给 控制 台 的 方式 对 远程 Web 








服务 来 说 是 不 可 行 的 。 
a 解决 方案 : 已 经 讨论 过 了 ,通过 适 配 带 访问 的 Log4Net 已 经 提供 了 非常 丰富 的 日 志 记 录 
方法 了 。 


口 需求 : 当 数 据 库 也 发 生 了 某 些 变化 时 ， 也许 是 insert_trade 存 储 过 程 也 需要 一 个 额外 的 

代理 人 参数 ， 或 者 你 决定 使 用 文档 存储 来 代替 关系 型 数据 库 ， 又 或 者 将 数据 库 移 到 你 所 

使 用 的 Web 服 务 后 台 。 

m 解决 方案 : 如 果 存 储 过 程 改 变 了 ， 你 需要 编辑 AdoNetTradeStorage1 类 来 包含 代理 人 
数据 的 处 理 。 对 于 其 他 两 个 改变 ， 你 需要 创建 MongoTradeStorage 类 来 使 用 MongoDB 
存储 交易 数据 ,你 还 需要 创建 一 个 ServiceTradeStorage 类 来 隐藏 Web 服 务 后 的 实现 。 

我 希望 现在 你 已 经 对 使 用 接口 进行 抽象 ， 按 照 阶 梯 模 式 解 耦 程序 集 , 渐进 地 重 构 ， 以 及 坚持 
单 职责 原则 这 些 方式 很 有 信心 了 ， 合理 地 组 合 使 用 它们 才能 编写 出 自 适应 代码 。 

让 代码 清晰 地 委托 抽象 完成 自身 职责 的 方式 还 有 很 多 种 。 本 章 剩 余部 分 会 集中 讲解 能 让 每 个 
类 都 集中 在 单个 职责 上 的 其 他 方式 。 


5.2 单一 职责 原则 和 修饰 器 模式 


修饰 絮 模 式 ( Decorator Pattern，DP ) 能 够 很 好 地 确保 每 个 类 只 有 单个 职责。 一 般 情 况 下 ， 
完成 很 多 事情 的 类 并 不 能 轻易 地 将 职责 划分 到 其 他 类 型 中 ， 因 为 很 多 职责 看 起 来 是 相互 关联 的 。 

修饰 需 模 式 的 前 置 条 件 是 : 每 个 修饰 需 类 实现 一 个 接口 且 能 同时 接受 一 个 或 多 个 同一 个 接 
口 实例 作为 构造 函数 的 输入 参数 。 这 样 做 的 好 处 是 ， 可 以 给 已 经 实现 了 某 个 特定 接口 的 类 添加 
































功能 ， 而 且 修 饰 硕 同时 也 是 所 需 接口 的 一 个 实现 ， 并 且 对 用 户 不 可 见 。 图 5-4 展 示 了 修饰 硕 模 式 


<<|INTERFACE> > 
IComponent 


的 UML 图 。 


ConcreteComponent 


+Something() 





+Something() 
图 5-4 ”修饰 器 模式 实现 的 UML 图 


代码 清单 5-13 展 示 了 该 模式 的 一 个 简单 示例 ， 它 只 是 一 个 概念 上 的 实例 ， 无 法 实际 使 用 。 
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代码 清单 5-13 ”修饰 带 模 式 的 示例 


public interface IComponent 





{ 
void SomethingQ; 
} 
/Te 
public class ConcreteComponent : IComponent 
{ 
public void Something () 
{ 
} 
} 
CO 
public class DecoratorComponent : IComponent 
{ 
public DecoratorComponent(IComponent decoratedComponent) 
{ 
this.decoratedComponent = decoratedComponent; 
} 
public void Something () 
{ 
SomethingElse(); 
decoratedComponent .Something() ; 
} 
private void SomethingElse() 
{ 
} 
private readonly IComponent decoratedComponent ; 
} 
/es 
class Program 
{ 
static IComponent component; 
static void Main(string[] args) 
{ 
component = new DecoratorComponent (Cnew ConcreteComponent() ) ; 
Component .Something () ; 
} 
} 


上 面 的 代码 示例 中 , 客户 端 从 构造 函数 方法 参数 中 接受 了 接口 实例 , 你 可 以 给 用 户 提 供 原 有 
的 未 修饰 类 的 实例 , 也 可 以 提供 已 修饰 类 的 实例 。 注音, 无论 你 提供 的 是 未 修饰 的 原始 类 还 是 已 
修饰 的 类 ， 客 户 端 都 无 需 做 任何 改变 。 
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5.2.1 复合 模式 


复合 模式 ( Composite Pattern ) 是 修饰 器 模式 的 一 个 特例 ， 也 是 应 用 最 广泛 的 修饰 器 模式 。 
图 5-5 展 示 了 复合 模式 的 UML 图 。 













<<INTERFACE>> 
IComponent 


Composite 


+Something() a 
-memberName 


+9Something() 


for(var child in components) < 
child.Something(); 
图 5-5 ”复合 模式 和 修饰 顺 模 式 非常 相似 


复合 模式 的 目的 就 是 让 你 能 把 某 个 接口 的 一 组 实例 看 作 该 接口 的 一 个 实例 。 因 此 , 客户 端 只 
需要 接受 接口 的 一 个 实例 , 在 无 需 任 何 改变 的 情况 下 就 能 隐 式 地 使 用 该 接口 的 一 组 实例 。 代 码 清 
单 5-14 展 示 了 一 个 实践 中 的 复合 修饰 带 。 
代码 清单 5-14 一 个 接口 的 组 合 实现 


public interface IComponent 











{ 
void SomethingQO; 
} 
7 
public class Leaf : IComponent 
{ 
public void Something () 
{ 
} 
} 
/a 
public class CompositeComponent : IComponent 
{ 
public CompositeComponent() 
{ 
children = new List<IComponent>() ; 
} 


public void AddComponent(IComponent component) 
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{ 
children.Add(component); 
} 
public void RemoveComponent(IComponent component) 
{ 
children.Remove(component); 
} 
public void Something () 
{ 
foreach(var child in children) 
{ 
child.SomethingQO; 
} 
} 
private ICollection<IComponent> children; 
} 
/Re 
class Program 
{ 
static void Main(string[] args) 
{ 
var composite = new CompositeComponent(); 
composite.AddComponent (new Leaf()); 
composite.AddComponent (new Leaf()); 
composite.AddComponent (new Leaf()); 
component = composite; 
component.Something(); 
} 
static IComponent component; 
} 


CompositeComponent 类 中 有 增删 IComponent 接 口 实 例 的 方法 。 这 些 方法 并 不 是 IComp- 
onent 接 口 的 组 成 部 分 ， 只 被 CompositeComponent 类 的 客户 端 直 接 使 用 。 无 论 哪个 创建 
CompositeComponent 类 实例 的 工程 方法 或 类 型 ， 也 都 需要 能 创建 被 修饰 的 实例 并 将 它们 传人 到 
Add 方 法 ; 和 否则， 使 用 IComponent 接 口 的 客户 端 就 必须 为 了 配合 组 合 而 做 改变 。 

无 论 客户 端 何 时 调用 CompositeComponent 类 的 Something 方 法 ， 组 合 列表 中 的 所 有 
IComponent 接 口 实例 的 Something 方 法 都 会 被 调用 一 次 。 这 就 是 你 将 IComponent 接 口 的 单个 实 
例 (实现 该 接口 的 CompositeComponent 类 ) 的 调用 重新 路 由 给 该 接口 的 很 多 实例 〈 实 现 该 接口 
的 叶 类 ) 的 方式 。 

每 个 你 提供 给 CompositeComponent 类 的 实例 都 必须 实现 IComponent 接 口 (这 是 由 编译 带 
根据 C# 语 言 的 强 类 型 特性 来 保证 的 )， 但 是 这 些 实例 不 一 定 是 同一 种 具体 实现 类 。 借 助 多 态 的 强 
大 能 力 ， 你 能 把 所 有 该 接口 的 实现 类 的 实例 只 看 作 接 口 的 实例 。 代 码 清单 5-15 展 示 了 一 个 复合 模 
式 增 强 应 用 的 示例 , 其 中 提供 给 CompositeComponent 类 的 是 多 种 不 同 的 实现 IComponent 接 口 的 
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子 类 。 
代码 清单 5-15 ”提供 给 组 合 列表 的 实例 可 以 是 不 同 的 子 类 


public class SecondTypeOfLeaf : IComponent 





{ 
public void Something () 
{ 
} 

} 

Se 

public class AThirdLeafType : IComponent 

{ 
public void Something () 
{ 
} 

} 

AS 

public void AlternativeComposite() 

{ 
var composite = new CompositeComponent() ; 
composite.AddComponent(new Leaf()); 
composite.AddComponent(new SecondTypeOfLeaf QO); 
composite.AddComponent(new AThirdLeafType()); 
component = composite; 
composite.Something(); 

} 





根据 复合 模式 的 逻辑 设计 ， 你 甚至 可 以 通过 Add 方 法 添加 一 个 或 多 个 CompositeComponent 
类 的 实例 ， 这 样 就 可 以 形成 树 状 层次 结构 的 一 组 实例 链 。 


何 时 使 用 组 合 ? 
第 2 章 介绍 的 随从 反 模 式 告 诉 我 们 ， 实 现 不 应 该 与 其 接口 位 于 相同 的 程序 集中 。 然 而 ， 
该 规则 有 个 例外 情况 : 当 实 现 的 依赖 是 接口 依赖 的 子 集 时 。 
有 些 组 合 的 具体 实现 并 不 会 引入 更 多 的 依赖 , 在 这 种 情况 下 ,组 合 类 接口 所 在 的 程序 集 
也 可 以 同时 包含 组 合 类 的 具体 实现 。 


第 2 章 中 ， 可 以 将 类 实例 建 模 为 对 象 图 。 这 里 继续 使 用 对 象 图 来 进一步 展示 复合 模式 的 工作 
方式 。 图 5-6 中 ， 图 中 节点 表示 对 象 实例 ， 有 癌 边 线 则 代表 了 方法 调用 。 
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Composite 


人 人) 
人) 6 





图 5-6 ”对 象 图 可 以 形象 地 展示 程序 的 运行 时 结构 


5.2.2 ”谓词 修饰 器 


谓词 修饰 胡 ( Predicate Decorator ) 能 够 很 好 地 消除 客户 端 代码 中 的 条 件 执行 语句 。 代 码 清单 
5-16 展 示 了 一 个 示例 。 


代码 清单 5-16 ”客户 端 代码 只 会 在 每 月 的 双 数 日 执行 Something 方 法 


public class DateTester 


{ 
public bool TodayIsAnEvenDayOfTheMonth 
{ 
get 
{ 
return DateTime.Now.Day % 2 == 0; 
} 
} 
} 
AR 
class PredicatedDecoratorExample 
{ 


public PredicatedDecoratorExample(IComponent component) 


{ 


this.component = component; 


} 
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public void RunQO 


{ 
DateTester dateTester = new DateTester(); 
if (dateTester.TodayIsAnEvenDayOfTheMonth) 
{ 
component.Something(); 
} 
} 


private readonly IComponent component; 


上 面 示例 中 的 DateTester 类 是 谓词 修饰 带 类 的 一 个 依赖 项 。 第 一 次 重 构 的 目标 代码 如 代码 
清单 5-17 所 示 。 但 是 ， 它 还 只 是 一 个 不 完整 的 方案 。 


代码 清单 5-17 “将 依赖 传人 类 的 改进 


class PredicatedDecoratorExample 





{ 
public PredicatedDecoratorExample(IComponent component) 
{ 
this.component = component; 
} 
public void Run(DateTester dateTester) 
{ 
if (dateTester.TodayIsAnEvenDayOfTheMonth) 
{ 
component.Something(); 
} 
} 
private readonly IComponent component; 
} 


现在 你 要 求 给 Run 方 法 传人 一 个 DateTester 人 参数 ， 但 这 样 就 破坏 了 客户 端的 公共 接口 设计 ， 
并 要 求 它 的 客户 端 去 实现 DateTester 类 。 此 时 ， 如 有 果 应 用 修饰 希 模 式 ， 你 依然 能 保持 现 有 客户 
端 公共 接口 的 设计 ， 同 时 也 能 保持 根据 条 件 执行 动作 的 能 力 。 代 码 清单 5-18 证 明了 这 样 重 构 后 的 
结果 依然 不 够 好 。 


代码 清单 5-18 ”谓词 修饰 大 包含 了 依赖 ， 客 户 端 代码 接口 保持 不 变 而 且 实现 更 加 简洁 了 


public class PredicatedComponent : IComponent 


{ 





public PredicatedComponent(IComponent decoratedComponent, DateTester dateTester) 
{ 

this.decoratedComponent = decoratedComponent; 

this.dateTester = dateTester; 
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public void Something() 


{ 
if(dateTester.TodayIsAnEvenDayOfTheMonth) 
{ 
decoratedComponent .Something() ; 
} 
} 


private readonly IComponent decoratedComponent ; 
private readonly DateTester dateTester ; 





} 
pH 
class PredicatedDecoratorExample 
{ 
public PredicatedDecoratorExample(IComponent component) 
{ 
this.component = component; 
} 
public void RunQO 
{ 
component.Something(); 
} 
private readonly IComponent component; 
} 








上 面 示例 中 将 条 件 分 支 添 加 到 了 谓词 修饰 絮 中 ， 并 没有 改动 客户 端 代 码 或 原 有 的 其 他 实现 
类 ,虽然 也 给 谓词 修饰 器 类 引信 了 对 DateTester 类 的 依赖 ， 但 是 你 可 以 通过 定义 专门 的 谓词 接 
口 来 更 加 通用 地 处理 这 种 具有 条 件 分 支 的 场景 。 代 码 清 单 5-19 展 示 的 是 重 构 后 的 代码 。 
代码 清单 5-19 ”定义 一 个 被 修饰 的 IPredicate 接 口 ， 可 以 让 解决 方案 更 加 通用 


public interface IPredicate 





{ 
bool Test() ; 
} 
2 
public class PredicatedComponent : IComponent 
{ 
public PredicatedComponent(IComponent decoratedComponent, IPredicate predicate) 
{ 
this.decoratedComponent = decoratedComponent; 
this.predicate = predicate; 
} 


public void Something() 

{ 
if (predicate.Test()) 
{ 


decoratedComponent .Something () ; 
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private readonly IComponent decoratedComponent; 
private readonly IPredicate predicate; 


} 
ON 
public class TodayIsAnEvenDayOfTheMonthPredicate : IPredicate 
{ 
public TodayIsAnEvenDayOfTheMonthPredicate(DateTester dateTester) 
{ 
this.dateTester = dateTester; 
} 
public bool TestQO 
{ 
return dateTester.TodayIsAnEvenDayOfTheMonth; 
} 
private readonly DateTester dateTester; 
} 


现在 由 实现 了 IPredicate 接 口 的 TodayIsAnEvenDay0fTheMonthPredicate 类 来 依赖 Date- 
Tester 类 。 这 也 是 $.1.2 节 中 讨论 过 的 适 配 需 模式 的 示例 。 





注意 .NET Framework 从 2.0 版 开始 就 提供 了 一 个 Predicate<T> 委 托 ， 它 对 谓词 进行 了 建 
模 ， 可 以 接受 单个 泛 型 参数 作为 谓词 的 上 上下文。 我 没有 在 上 面 的 示例 中 选择 使 用 
Predicate<T>， 这 有 两 个 原因 : 第 一 ， 并 不 需要 任何 上 下 文 信 息 ， 因 为 原 有 的 条 件 测 试 并 
不 需要 参数 。 然 而 ， 我 依然 可 以 使 用 一 个 Func<boo1> 委 托 来 表示 一 个 无 需 上 下 文 的 谓词 ， 
这 也 引出 了 我 不 选用 它 的 第 二 个 理由 : 委托 并 不 像 接口 那样 通用 。 通 过 设计 IPredicate 接 
口 ， 我 能 够 在 后 期 用 同样 的 方式 来 修饰 它 。 也 就 是 说 ， 接 口 提 供 了 一 个 可 以 不 断 扩 展 修饰 的 
切入 点 。 


5.2.3 分支 修 饰 器 


你 还 可 以 通过 接受 另 一 个 接口 实例 并 在 条 件 判断 不 为 真 的 分 文 下 完成 某 些 动作 来 对 谓词 修 
饰 帮 做 进一步 的 扩展 ， 如 代码 清单 5-20 所 示 。 
代码 清单 5-20 ”分支 修 饰 融 接受 两 个 组 件 和 一 个 请 词 


public class BranchedComponent : IComponent 


{ 








public BranchedComponent(IComponent trueComponent, IComponent falseComponent, 
IPredicate predicate) 
{ 


this.trueComponent = trueComponent; 
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this.falseComponent = falseComponent; 
this.predicate = predicate; 


} 
public void Something() 
{ 
if (predicate.Test()) 
{ 
trueComponent.SomethingQ); 
} 
else 
{ 
falseComponent .Something() ; 
} 
J} 


private readonly IComponent trueComponent; 
private readonly IComponent falseComponent; 
private readonly IPredicate predicate; 





无 论 何 时 调用 谓词 进行 判断 ， 如 果 返 回 值 为 真 ,就 调用 trueComponent 实 例 的 Something 方 
法 ， 如 果 返 回 值 不 为 真 ， 就 调用 falseComponnet 实 例 的 Something 方 法 。 
5.2.4 延迟 修饰 器 


延迟 修饰 需 允 许 客户 端 提供 某 个 接口 的 引用 , 但 是 直到 第 一 次 使 用 它 时 才 进 行 实例 化 。 通常 
客户 端 直 到 看 到 传人 的 Lazy<T> 参 数 时 才 会 觉察 到 延迟 实例 的 存在 ， es 它们 知道 有 延 
述 实 例 存 在 的 细节 信息 。 代 码 清单 5-21 展 示 了 一 个 这 样 的 示例 。 
代码 清单 5-21 客户 端 接 受 了 一 个 Lazy<T> 参 数 


public class ComponentClient 











{ 
public ComponentClient(Lazy<IComponent> component) 
{ 
this.component = component; 
} 
public void RunQO 
{ 
component.Value.SomethingQ); 
} 
private readonly Lazy<IComponent> component; 
} 


上 面 示例 中 的 客户 端 代码 只 有 一 个 构造 函数 ， 且 只 能 接受 延迟 实例 化 的 IComponent 接 口 的 
实例 。 然而 ,基于 该 接口 更 标准 的 使 用 方式 ,你 还 可 以 选择 创建 一 个 延迟 修饰 各 ,这样 就 可 以 防 
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止 客户 端 知 道 正在 处 理 的 是 Lazy<T> 实 例 , 而 且 也 人 允许 一 些 ComponentC1ient 对 象 接受 非 延 迟 实 
例 化 的 IComponent 实 例 。 代 码 清单 5S-22 展 示 了 延迟 修饰 顺 的 实现 。 


代码 清单 5-22 LasyComponent 类 是 IComponent 接 口 的 一 个 延迟 实例 化 的 实现 ， 但 是 
ComponentC1ient 并 不 知道 这 些 细节 


public class LazyComponent : IComponent 
public LazyComponent(Lazy<IComponent> lazyComponent) 
{ 
this.1azyComponent = lazyComponent; 


} 


public void Something () 
{ 

1azyComponent .Value.Something() ; 
} 


private readonly Lazy<IComponent> lazyComponent; 
} 
CE 


public class ComponentClient 


{ 


public ComponentClient(IComponent component) 
{ 
this.component = component; 


} 
public void Run() 
Component .Something(D) ; 


} 


private readonly IComponent component; 


5.2.5 日 志 记 录 修 饰 器 


代码 清单 5-23 展 示 的 示例 是 代码 包含 大 量 日 志 语 句 的 一 种 常见 情况 。 日 志 代 码 在 应 用 程序 中 
无 处 不 在 ， 严 重地 拉 低 了 有 效 代码 率 。 
代码 清单 5-23 日 志 代码 影响 了 方法 意图 的 连贯 表达 


public class ConcreteCalculator : ICalculator 


{ 








public int Add(int x, int y) 
{ 
Console.WriteLine("Add(x={0}, y={1})", x, y); 
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var addition = x +y; 
Console.WriteLine("result={0}", addition); 


return addition; 








你 可 以 专门 实现 一 组 日 志 记 录 修 饰 需 的 程序 集 来 解决 这 种 应 用 程序 中 日 志 代码 满天飞 的 问 
， 如 代码 清单 5-24 所 示 。 


代码 清单 5-24 日 志 记 录 修 饰 紫 能 提取 出 日 志 语 句 ， 让 方法 功能 的 实现 看 起 来 更 简洁 


public class LoggingCalculator : ICalculator 








{ 
public LoggingCalculator(ICalculator calculator) 
{ 
this.calculator = calculator; 
} 
public int Add(int x, int y) 
{ 
Console.WriteLine("Add(x={0}, y={1})", x, y); 
var result = calculator.Add(x, y); 
Console.WriteLine("result={0}", result); 
return result; 
} 
private readonly ICalculator calculator; 
} 
i 
public class ConcreteCalculator : ICalculator 
{ 
public int Add(int x, int y) 
{ 
return x + Yi 
} 
} 











ICalculator 接 口 的 客户 端 会 传人 多 个 参数 ， 有 些 接 口 方 法 本 映 也 会 有 返回 值 。 因 为 
LoggingCalculator 类 处 于 客户 端 和 接口 之 间 ， 因 此 它 可 以 将 二 者 直接 联系 起 来 。 当 然 ， 日志 
记录 修饰 需 的 使 用 有 一 些 局 限 性 需要 注意 。 第 一 , 被 修饰 类 中 的 所 有 私有 状态 一 样 对 日 志 记 录 修 
人 饰 器 不 因此 也 无 法 将 它们 写 人 日 志 。 第 一， 应 用 程序 中 的 每 个 接口 都 要 有 对 应 的 日 志 记 录 
修饰 希 ， 这 个 任务 工作 量 太 过 巨大 。 为 了 实现 同样 的 目的 ,应 该 用 日 志 记 录 方 面 来 代替 日 志 记 录 
修饰 锅 。 0 ( AOP ) 在 第 2 章 中 有 过 讲解 。 
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5.2.6 ”性 能 修饰 器 


基于 .NET Framework 平 台 开 发 应 用 的 最 大 优势 就 是 它 能 很 好 地 支持 快速 应 用 开发 ( Rapid 
Application Development，RAD )。 与 诸如 C++ 等 低级 编码 语言 相 比 ， 使 用 C# 开 发 同一 个 可 工作 的 
应 用 程序 需要 的 时 间 要 少 很 多 。 此 外 , 它 还 有 诸如 .NET Framework 的 自动 内 存 管理 ,丰富 的 可 用 
库 ， 以 及 强大 的 .NET Framework 本 里 等 其 他 一 些 优 势 。 通 常情 况 下 ，C# 被 认为 有 助 于 提高 开发 
效率 ,但 开发 出 的 应 用 程序 运行 速度 相对 却 比 较 慢 。 相 反 ，C++ 会 被 认为 开发 效率 偏 慢 , 但 开发 
出 的 应 用 程序 的 运行 速度 却 比 C# 快 很 多 。 

尽管 基于 .NET Framework 开 发 应 用 程序 的 效率 比较 高 ， 但 它 在 运行 时 很 可 能 存在 性 能 瓶颈 。 
那么 , 你 又 如 何 知道 哪些 代码 的 性 能 比较 差 呢 ? 通过 对 应 用 程序 进行 性 能 分 析 , 你 能 得 知 哪些 代 
人 码 比 其 他 代码 性 能 差 的 统计 结果 。 先 来 看 看 代码 清单 5-25 的 示例 代码 。 


代码 清单 5-25 (故意 设计 出 的 ) 性 能 比较 差 的 代码 


public class SlowComponent : IComponent 




















{ 
public SlowComponent() 
{ 
random = new Random((int)DateTime.Now.Ticks); 
} 
public void Something () 
{ 
for(var 1 = 0; 1<100; ++1) 
{ 
Thread.Sleep(random.Next(1) * 10); 
} 
了 


private readonly Random random 


} 

上 面 示例 中 的 Something 方 法 性 能 很 差 。 当 然 ， 性 能 的 好 坏 都 是 相对 的 。 现 在 这 个 示例 里 ， 
一 个 性 能 差 的 方法 定义 是 执行 时 间 超 过 了 一 秒 钟 。 那 义 如 何 判 断 一 个 方法 是 否 符 合 这 个 性 能 差 的 
定义 呢 ? 你 可 以 通过 对 方法 执行 始末 计时 来 判定 ， 如 代码 清单 5-26 所 示 。 
代码 清单 5-26 System.Disgnostics.Stopwatch 类 可 以 对 方法 执行 时 间 进 行 计 时 


public class SlowComponent : IComponent 


{ 
public SlowComponent() 
{ 
random = new Random((int)DateTime.Now.Ticks); 
stopwatch = new Stopwatch() ; 
} 


public void Something() 
{ 
Stopwatch .Start() ; 
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for(var 1 = 0; 1<100; ++1) 
{ 
System.Threading.Thread.SleepCrandom.Next(1) * 10); 
} 
stopwatch.Stop() ; 
Console.WriteLine("The method took {0} seconds to complete", 
stopwatch.ElapsedMilliseconds / 1000); 
} 


private readonly Random random; 
private readonly Stopwatch; 





这 里 使 用 的 Stopwatch 类 包含 在 System.Diagnosticas 程 序 集中 ， 它 可 以 用 来 对 每 个 方法 
计时 。 可 以 看 到 上 面 示例 代码 中 的 Something 方 法 在 入 口 启动 了 秒表 ， 在 出 口 停止 了 秒表 。 

当然 ,可 以 把 这 个 功能 提取 到 一 个 性 能 修饰 妖 中 。 对 整个 要 测试 性 能 的 接口 进行 修饰 ， 而且 
在 委托 被 修饰 的 实例 前 ， 启 动 秒表。 在 被 修饰 实例 的 方法 返回 后 ,停止 秒表 。 代 码 清单 5-27 展 示 
了 使 用 秒表 的 性 能 修饰 妖 的 代码 。 


代码 清单 5-27 ”性 能 修饰 器 的 代码 


public class Profi lingComponent : IComponent 

















{ 
public ProfilingComponent(IComponent decoratedComponent) 
{ 
this.decoratedComponent = decoratedComponent; 
stopwatch = new Stopwatch() ; 
} 


public void Something () 
{ 
stopwatch.Start() ; 
decoratedComponent .Something() ; 
stopwatch.Stop() ; 
Console.WriteLine("The method took {0} seconds to complete", 
stopwatch.ElapsedMilliseconds / 1000); 
} 


private readonly IComponent decoratedComponent ; 
private readonly Stopwatch stopwatch; 


在 此 基础 上 ， 还 可 以 对 Profi11ingComponent 再 做 一 次 重 构 : 消除 性 能 日 志 语 句 。 第 一 ， 
需要 把 秒表 局 停 和 计算 时 间 间 隔 的 代码 提取 并 隐藏 在 一 个 接口 后 ， 这 样 你 就 可 以 提供 多 种 实现 ， 
包括 修饰 器 。 这 通常 就 是 在 朝 着 更 好 的 职责 划分 目标 进行 重 构 时 的 第 一 步 。 代 码 清单 $-28 展 示 了 
这 个 中 间 状 态 。 
代码 清单 5-28 在 实现 修饰 锅 前 ， 你 必须 先 用 接口 蔡 换 具 体 的 实现 


public class ProfilingComponent : IComponent 
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{ 
public ProfilingComponent(IComponent decoratedComponent, IStopwatch stopwatch) 
{ 
this.decoratedComponent = decoratedComponent ; 
this.stopwatch = stopwatch ; 
} 
public void Something () 
{ 
stopwatch .Start() ; 
decoratedComponent .Something() ; 
var elapsedMilliseconds = stopwatch.Stop() ; 
Console.WriteLine("The method took {0} seconds to complete", elapsedMilliseconds / 
1000); 
} 
private readonly IComponent decoratedComponent ; 
private readonly IStopwatch stopwatch ; 
} 


现在 , Profi11ingComponent 类 不 在 直接 依赖 系统 的 System.Diagnostics.StopWatch 类 ， 
你 可 以 更 改 IStopWatch 接 口 的 实现 。 基 于 IStopWatch 接 口 实现 的 LoggingStopwatch 修 饰 需 ， 
能 够 为 后 续 IStopWatch 的 实现 提供 日 志 功 能 ， 如 代码 清单 5-29 所 示 。 


代码 清单 5-29 ” LoggingStopwatch 修 饰 硕 类 是 IStopwatch 的 一 个 实现 ， 它 记录 日 志 并 委托 其 
他 IStopwatch 实 现 完成 真正 的 计时 动作 


public class LoggingStopwatch : IStopwatch 








{ 

public LoggingStopwatch(IStopwatch decoratedStopwatch) 

{ 
this.decoratedStopwatch = decoratedStopwatch; 

} 

public void Start() 

{ 
decoratedStopwatch.sStart() ; 
Console.WriteLine("Stopwatch started..."); 

} 


public long StopQO 
{ 
var elapsedMilliseconds = decoratedStopwatch .Stop() ; 
Console.WriteLine("Stopwatch stopped after {0} seconds", 
TimeSpan.FromMilliseconds(elapsedMilliseconds).TotalSeconds); 
return elapsedMilliseconds; 


} 


private readonly IStopwatch decoratedStopwatch; 
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当然 ， 你 需要 一 个 IStopwatch 接 口 的 非 修饰 咒 实 现 ， 它 会 完成 真正 的 秒表 功能 。 代 码 清 
5-30 展 示 的 示例 直接 利用 了 .NET Framework 的 System.Diagnostics.Stopwatch 类 。 


代码 清单 5-30 ”下 面 I Stopwatch 接 口 的 实现 主要 使 用 了 已 有 的 Stopwatch 类 


public class StopwatchAdapter : IStopwatch 


{ 
public StopwatchAdapter(Stopwatch stopwatch) 
{ 
this.stopwatch = stopwatch; 
} 
public void Start() 
{ 
stopwatch.StartQO; 
} 
public long StopQO 
{ 
stopwatch.Stop() ; 
var elapsedMilliseconds = stopwatch.ElapsedMilliseconds; 
stopwatch.Reset() ; 
return elapsedMilliseconds; 
} 
private readonly Stopwatch stopwatch; 
} 


注意 ， 你 也 可 以 将 IStopwatch 的 实现 作为 System.Diagnostics.Stopwatch 类 的 子 类 以 利 
用 它 已 有 的 Start 和 Stop 方 法 。 然 而 ，Stopwatch 类 的 Start 方 法 在 秒表 停止 后 再 次 调用 的 意图 
是 继续 前 一 次 的 计时 ， 因 此 你 需要 在 调用 Stopwatch 类 的 Stop 方 法 以 及 取出 Elapsed- 
Mi11iseconds 属 性 值 后， 立即 调用 它 的 Reset 方 法 。 这 也 是 适配器 模式 的 另 一 个 示例 。 





5.2.7 异步 修饰 器 


异步 方法 是 指 与 客户 端 代码 运行 在 不 同 线程 上 的 方法 。 异步 方 式 在 方法 执行 需要 很 长 时 间 的 
情况 下 很 用， 因为 在 同步 执行 期 间 ， 客 户 端 代码 会 被 完全 阻塞 直到 从 该 方法 返回 。 比 如 , 在 使 
用 WPF 和 MVVM 模 式 的 桌面 应 用 程序 里 , 绑 定 在 视图 上 的 视图 模型 是 运行 在 用 户 界 面 线 程 上 的 ， 
它 包含 的 所 有 命令 都 是 以 同步 方式 进行 处 理 的 。 在 实际 应 用 中 , 这 就 意味 着 长 时 间 运 行 的 命令 会 
阻 窒 用 户 界面 直到 该 命令 完成 它 的 工作 。 代 码 清 单 5-31 展 示 了 这 种 阻 窗 现象 的 代码 示例 。 


代码 清单 5-31 用 户 界面 线程 上 的 命令 会 阻 窗 用 户 界 面 ， 从 而 导致 用 户 界面 不 响应 


public class MainWindowViewModel : INotifyPropertyChanged 
{ 























public MainwindowViewModel(IComponent component) 
{ 


this.component = component; 





calculateCommand = new RelayCommand(Calculate); 


} 
public string Result 
{ 
get 
{ 
return result; 
} 
private set 
{ 
if (result != value) 
{ 
result = value; 
PropertyChanged(this, new PropertyChangedEventArgs("Result")); 
} 
} 
} 
public ICommand CalculateCommand 
{ 
get 
{ 
return calculateCommand; 
} 
} 


public event PropertyChangedEventHandler PropertyChanged = delegate { }; 


private void Calculate(object parameter) 


{ 
Result = "Processing...",; 
Component .Process() ; 
Result = "Finished!"; 

} 


private string result; 
private IComponent component; 
private RelayCommand calculateCommand; 





通过 创建 一 个 异步 修饰 器 , 你 可 以 指示 被 调用 的 方法 在 一 个 单独 的 线程 中 执行 。 这 可 以 通过 
将 具体 工作 委托 给 一 个 Task 类 的 实例 来 实现 ， 它 也 会 变 成 你 的 异步 修饰 絮 的 依赖 ， 如 代码 清单 
5-32 所 示 。 


代码 清单 5-32 一 个 为 WPF 使 用 Dispatcher 类 的 异步 修饰 妖 


public class AsyncComponent : IComponent 
{ 
public AsyncComponent(IComponent decoratedComponent) 


{ 


this.decoratedComponent = decoratedComponent; 
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} 
public void Process() 
{ 
Task.Run((Action)decoratedComponent.Process); 
} 


private readonly IComponent decoratedComponent ; 


} 


示例 中 的 AsyncComponent 类 有 一 个 问题 : 它 隐 式 依赖 Task 类 ， 这 就 意味 着 很 难 测试 它 。 使 
用 静态 依赖 的 代码 很 难 进行 单元 测试 ， 因 此 你 最 好 选 个 塔吊 替代 这 个 天 和 钩 。 

异步 修饰 器 的 局 限 性 

并 不 是 所 有 方法 都 可 以 使 用 修饰 需 模 式 提 供给 客户 端 并 不 可 见 的 异步 版 本 。 实 际 上 ， 只 有 那 
些 即 发 即 弃 ( fire-and-forget ) 的 方法 才 可 以 应 用 异步 修饰 磊 。 

一 个 即 发 即 弃 的 方法 并 没有 返回 值 ， 客户 端 代 码 无 需 知道 这 个 方法 何 时 返回 调用 。 如 果 一 个 
方法 实现 为 异步 修饰 器 ,客户 端 代码 就 无 法 知道 该 方法 什么 时 候 才 真正 完成 , 因为 对 它 的 调用 会 
立即 返回 ， 实 际 上 真正 要 执行 的 工作 很 可 能 依然 在 进行 中 。 

请 求 -响应 ( request-response ) 方法 通常 用 来 获取 数据 ， 也 经 常会 被 实现 为 异步 方法 ， 因 为 
这 些 方法 通常 会 花 点 时 间 且 阻 寨 UI 线 程 。 客户 端 需要 知道 该 方法 是 异步 的 , 这 样 它们 就 可 以 显 式 
编写 回调 以 便 在 该 异步 方法 完成 时 得 到 通知 。 因 此 ， 请 求 - 啊 应 方法 并 不 适合 使 用 异步 修饰 如 来 
实现 。 


5.2.8 ”修饰 属性 和 事件 


到 目前 为 止 , 你 学 到 的 都 是 如 何 修饰 接口 的 方法 , 那么 属性 和 事件 能 被 修饰 吗 ?” 答案 是 肯定 
的 。 为 了 修饰 它们 ， 你 需要 显 式 定义 它们 而 不 是 使 用 自动 属性 和 目 动 事件 。 

代码 清单 5-33 展 示 了 手动 创建 的 属性 , 它 的 人 存 取 带 直接 委托 被 修饰 实例 的 存 取 天 ， 而 不 是 使 
用 二 个 后 备 字 上 把。 


代码 清单 5-33 ”属性 也 可 以 像 方法 一 样 使 用 修饰 希 模式 


public class ComponentDecorator : IComponent 




















{ 
public ComponentDecorator(IComponent decoratedComponent) 
{ 
this.decoratedComponent = decoratedComponent; 
} 
public string Property 
1 
get 
1 


// We can do some mutation here after retrieving the value 
return decoratedComponent .Property ; 
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// And/or here, before we set the value 
decoratedComponent.Property = value; 


} 


private readonly IComponent decoratedComponent ; 


代码 清单 5-34 展 示 了 一 个 手动 创建 的 事件 , 它 的 添加 需 和 移 除 希 直 接 委 托 被 修饰 实例 的 事件 
的 添加 和 移 除 方式 ， 而 不 是 使 用 一 个 后 备 字 段 。 





代码 清单 5-34 ”事件 也 可 以 像 方法 一 样 使 用 修饰 大 模式 


public class ComponentDecorator : IComponent 


{ 
public ComponentDecorator (IComponent decoratedComponent) 
{ 
this.decoratedComponent = decoratedComponent ; 
} 
public event EventHandler Event 
1 
add 
1 
// We can do something here, when the event handler is registered 
decoratedComponent .Event += value; 
} 
remove 
1 
// And/or here, when the event handler is deregistered 
decoratedComponent.Event -= value; 
} 
} 


private readonly IComponent decoratedComponent ; 


5.3 ”用 策略 模式 替代 switch 语句 


为 了 理解 应 用 策略 模式 的 最 佳 时 机 ， 你 可 以 看 看 条 件 分 文 的 场景 。 任 何 使 用 switch 语 句 的 
场合 ， 你 都 可 以 通过 策略 模式 将 复杂 性 委托 给 所 依赖 的 接口 以 简化 客户 端 代码 。 人 代码 清单 5-35 展 
示 了 一 个 可 以 使 用 策略 模式 蔡 换 的 switch 语 名 代码 示例 。 


代码 清单 5-35 ”这 个 方法 使 用 了 switch 语句 ， 但 是 策略 模式 能 提供 更 好 的 适应 变更 的 能 力 


public class OnlineCart 
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public void CheckOut(PaymentType paymentType) 
{ 
switch(paymentType) 
{ 
case PaymentType.CreditCard: 
ProcessCreditCardPayment() ; 
break ; 
case PaymentType.Paypal : 
ProcessPaypalPayment() ; 
break ; 
case PaymentType.QGoogleCheckout: 
ProcessGoog1lePayment() ; 
break ; 
case PaymentType.AmazonPayments : 
ProcessAmazonPayment() ; 
break ; 
} 
} 
private void ProcessCreditCardPayment() 
{ 
Console.WritelLine("Credit card payment chosen"); 
} 
private void ProcessPaypalPayment() 
{ 
Console.WritelLine("Paypal payment chosen"); 
} 
private void ProcessGooglePayment() 
{ 
Console.WritelLine("Google payment chosen"); 
} 
private void ProcessAmazonPayment() 
{ 
Console.WritelLine("Amazon payment chosen"); 
} 
} 


示例 中 , 对 应 switch 语 句 下 的 每 个 case 分 文 ， 类 的 行为 都 有 变化 。 这 种 方式 会 引入 代码 维护 
问题 ， 因 为 增加 任何 新 的 case 分 支 都 需要 更 改 这 个 类 。 相 反 ， 如 有 果 你 用 同一 接口 的 一 组 实现 来 蔡 
代 所 有 的 case 分 支 , 那么 后 续 还 可 以 增加 新 的 实现 来 封装 新 的 功能 , 而 且 客 户 端 代码 也 无 需 改变 。 
代码 清单 5-36 展 示 了 这 样 的 重 构 。 


代码 清单 5-36 替换 switch 语 名 后， 客户 端 代码 看 起 来 适应 变更 的 能 力 高 了 很 多 


public class OnlineCart 


{ 








public OnlineCart() 
{ 
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paymentStrategies = new Dictionary<PaymentType，IPaymentStrategy>() ; 

paymentStrategies.Add(PaymentType.CreditCard, new PaypalPaymentStrategy() ) ; 

paymentStrategies.Add(PaymentType.GoogleCheckout, new 
GoogleCheckoutPaymentStrategy()); 

paymentStrategies.Add(PaymentType.AmazonPayments, new 
AmazonPaymentsPaymentStrategy()); 

paymentStrategies.Add(PaymentType.Paypal, new PaypalPaymentStrategy OQ); 


} 
public void CheckOut(PaymentType paymentType) 
{ 
paymentStrategies[paymentTypel] .ProcessPayment() ; 
} 


private IDictionary<PaymentType, IPaymentStrategy> paymentStrategies ; 
} 


按照 面 回 对 象 编程 的 传统 ， 示 例 代 码 将 不 同 的 支付 类 型 具体 化 为 不 同 的 类 ， 它 们 都 实现 了 
IPaymentStrategy 接 口 。 这 个 示例 中 ，0On1ineCart 类 带 有 一 个 私有 的 字典 字段 ， 它 可 以 将 
PaymentType 枚 举 的 每 个 值 映 射 到 一 个 对 应 的 IPaymentStrategy 接 口 的 实例 上 。 这 个 字典 大 大 
地 简化 了 Checkout 方 法 的 复杂 度 。 不 仅 switch 语 名 被 移 除 了 ， 各 种 类 的 支付 处 理 过 程 也 随 之 不 
复 存 在 。0n1ineCart 类 不 需要 知道 如 何 处 理 文 付 ， 大 量 不 同 的 处 理 方式 会 给 该 类 引入 太 多 不 必 
要 的 依赖 。 现 在 的 0n1ineCart 类 只 是 选择 恰当 的 支付 策略 并 委托 它 来 完成 实际 处 理 过 程 。 

在 添加 新 的 支付 策略 实现 时 , 该 示例 依然 存在 一 个 维护 负担 ,比如 , 在 添加 实现 以 支持 WePay 
时 ， 你 就 需要 更 改 构 造 函 数 以 映射 新 的 WePayPaymentStrategy 类 给 对 应 的 WePay 枚 举 值 。 























5.4 总结 


单一 职责 原则 对 代码 目 适 应 能 力 有 着 至 关 重 要 的 正面 影响 。 与 不 应 用 该 模式 的 同样 功能 的 代 
码 相 比 , 符合 单一 职责 原则 的 代码 会 由 更 多 的 小 规模 但 目标 更 明确 的 类 组 成 。 单个 巨型 类 或 相互 
依赖 的 一 组 类 只 会 导致 职责 混淆 ， 而 单一 职责 原则 能 币 来 有 序 和 清晰 的 良好 效果 。 

单一 职责 原则 主要 是 通过 接口 抽象 以 及 在 运行 时 将 无 关 功能 的 责任 委托 给 相应 接口 完成 来 
达成 目标 的 。 一 些 设计 模式 (特别 是 适 配 融 模式 和 修饰 希 模 式 ) 非 常 适合 文 持 单一 职责 类 的 实现 。 
适 配 融 模式 能 让 你 的 绝 大 多 数 代码 都 引用 你 能 完全 控制 的 第 一 方 组 件 , 尽管 实际 上 是 在 利用 第 三 
方 库 。 当 一 个 类 的 某 些 功能 需要 被 移 除 但 这 些 功 能 又 和 该 类 意图 紧密 联系 时 , 就 可 以 应 用 修饰 可 
模式 。 

本 前 并 没有 讲解 所 有 这 些 类 运行 时 的 协作 方式 。 本 章 采 用 的 方式 是 将 接口 实例 传 和 构造 函数 
的 方式 ， 后 面 第 9 章 将 会 讲解 能 实现 同样 目标 的 多 种 不 同 的 方式 。 






































开放 与 封闭 原则 





完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 理解 开放 与 封闭 原则 的 不 同 解 释 。 

口 只 对 SOLID 代 码 做 追加 修改 。 

口 比较 和 对 比 不 同 的 类 扩展 机 制 。 

口 将 防止 变异 作为 扩展 点 的 指导 原则 。 

开放 与 封闭 原则 自 相 矛 盾 的 本 质 会 引起 很 多 困惑 。 顾名思义 , 该 原则 要 求 代码 既是 宽容 开放 
Eo cas 它 的 几 种 变 体 只 会 出 现在 云 相 关 的 场景 中 。 

是 选择 并 使 用 种 定义 对 我 来 训 是 个 可 以 接受 的 。 所 以 , 本 章 中 我 比较 了 所 有 定义 和 它们 

相应 的 影响 ， 以 便 控 掘 出 这 个 原则 的 本 质 。 清 楚 该 原则 的 本 质 有 助 于 你 编写 出 具有 更 强 自 适 应 能 
力 的 代码 。 


6.1 开放 与 封闭 原则 介绍 


有 两 种 不 同 的 开放 与 封闭 原则 定义 必须 要 介绍 到 ,它们 是 20 世 纪 80 年 代 的 最 原始 定义 和 后 
期 一 个 更 现代 的 定义 。 基 于 更 多 的 上 下 文 和 原则 范围 定义 ,后 者 尝试 了 对 前 者 进行 更 加 详尽 的 
阐述 。 

















6.1.1 Meyer 的 定义 


Bertrand Mayer 在 他 的 车 作 《 面 回 对 象 软件 构造 》 中 首次 定义 了 开放 与 封闭 原则 (Open/Closed 
Principle，OCP )， 具 体 定 义 如 下 所 示 。 
软件 实体 应 该 允许 扩展 ,但 禁止 修改 。 
Mayer 的 定义 是 被 引用 最 多 的 该 原则 的 定义 ， 但 是 Martin 也 给 出 了 另外 一 个 定义 。 


6.1.2 ”Martin 的 定义 


Robert C. Martin 定 义 的 开放 与 封闭 原则 在 过 去 的 十 几 年 里 有 很 多 种 不 同 的 写法 。 这 里 选择 的 
是 一 个 非常 详细 的 版 本 ,摘自 《敏捷 软件 开发 : 原则 、 模 式 与 实践 》， 以便 和 简短 的 原始 版 本 进 
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行 对 比 。 
“对 于 扩展 是 开放 的 。 这 意味 着 模块 的 行为 是 可 以 扩展 的 。 当 应 用 程序 的 需求 改变 
时 ， 我 们 可 以 对 其 模块 进行 扩展 ,使 其 具有 满足 那些 需求 变更 的 新 行为 。 换 多 话说 ， 我 
们 可 以 改变 模块 的 功能 。 
“对 于 修改 是 封闭 的 。 对 模块 行为 进行 扩展 时 ， 不 必 改 动 该 模块 的 源 代码 或 二 进 
制 代码 。 模 块 的 二 进 制 可 执行 版 本 ， 无 论 是 可 链接 的 库 、DLL 或 Java 的 ,jar 文件 ， 都 无 
需 改 动 。 


Martin 详 细 解释 了 Meryer 定 义 中 的 开放 与 封闭 原则 的 两 个 关键 词 。 对 于 扩展 是 开放 的 , Martin 
的 解释 是 ,开发 人 员 必 须 能 够 啊 应 需求 变更 并 文 持 新 的 特性 。 必 须要 做 到 这 一 点 ， 尽 管 模 块 对 修 
改 是 封闭 的 。 开 发 人 员 必 须 在 不 改动 已 有 模块 源 代码 或 程序 集 的 前 提 下 支持 新 的 功能 。 

在 继续 讲解 如 何 做 到 开放 与 封闭 原则 要 求 的 两 点 前 需要 指出 , 其 中 经 常 被 引用 的 “对 于 修改 
是 封闭 的 ”一 句 也 有 两 个 例外 : 修复 缺陷 所 做 的 改动 以 及 客户 端 无 法 感知 到 的 改动 。 


6.1.3 ”缺陷 修复 


缺陷 在 软件 中 很 常见 ， 是 不 可 能 完全 消除 的 。 但 当 它 们 出 现时 ， 你 需要 修复 问题 代码 。 当 
然 , 这 会 府 扯 到 修改 现 有 的 类 ,除非 你 愿意 为 修复 问题 将 现 有 类 的 实现 在 新 版 本 中 再 复制 一 份 。 
缺陷 修复 的 方式 听 起 来 似乎 有 些 令 人 费解 ， 它 明显 倾 问 于 实用 主义 而 不 是 坚持 纯正 的 开放 与 封 
闭 原 则 。 

下 面 列 出 修复 缺陷 流程 的 两 个 步 又 。 

(1) 针对 缺陷 编写 失败 的 单元 测试 和 /或 集成 测试 。 前 提 条 件 是 要 有 稳定 的 让 代码 失败 的 问题 
复 现 步骤 。 根 据 前 面 草 节 提 到 的 单元 测试 的 布置 、 动 作 和 断言 模式 定义 的 语法 ,你 需要 能 先 布置 
好 测试 目标 系统 以 便 让 它 处 在 能 触发 缺陷 的 状态 , 然后 执行 指定 的 包含 缺陷 的 动作 , 最 后 对 期 望 
的 行为 进行 断言 。 这 种 单元 测试 开始 时 总 是 失败 的 。 这 就 说 明了 所 有 问题 实际 上 是 由 缺乏 测试 引 
起 的 。 如 果 有 测试 用 于 捕获 这 个 缺陷 , 那么 该 测试 会 是 失败 的 , 当然 , 如 果 使 用 了 持续 集成 系统 ， 
它 也 会 报错 。 

(2) 修改 后 的 源 代码 才 可 以 通过 单元 测试 。 在 这 种 特定 情况 下 ， 违背 开放 与 封闭 原则 的 缺陷 
修复 也 是 很 有 必要 的 ,因为 如 果 没 有 它 , 你 将 无 法 修改 任何 现 有 代码 。 通 过 修改 测试 目标 系统 的 
实现 能 让 失败 的 单元 测试 由 红色 失败 状态 变 为 绿色 成 功 状态 。 当 你 能 确认 没有 产生 任何 副作用 ， 
也 就 是 不 会 导致 其 他 任何 测试 失败 时 ， 这 个 缺陷 就 已 经 被 成 功 修复 了 。 


























6.1.4 ”客户 端 感知 


一 个 更 加 违背 “对 于 修改 是 封闭 的 ”规则 的 例外 情况 是 : 允许 对 现 有 代码 做 任意 改动 ， 只 要 
它 不 会 引起 对 任 童 客户 端 代码 的 改动 。 它 着 重 强 调 软 件 模 块 在 所 有 粒度 级 别 上 如 何 炮 合 关联 , 包 
括 类 之 间 、 程 序 集 之 间 以 及 子 系统 之 间 。 

如 果 一 个 类 的 改动 会 引起 吃 外 一 个 类 的 改动 , 那么 这 两 个 类 就 是 紧密 耦合 的 。 相 反 ， 如 果 一 
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个 类 的 改动 是 独立 的 ， 并 不 会 引起 其 他 类 的 改动 , 那么 这 些 类 就 是 松散 兢 合 的 。 任 何 情况 下 ， 松 
散 和 耦合 都 比 紧密 耦合 要 好 。 如 果 你 对 现 有 代码 的 修改 不 会 影响 客户 端 代 码 , 那么 维护 这 样 松 散 耦 
合 的 代码 对 开放 与 封闭 原则 的 影响 是 有 限 的 。 


6.2 ”扩展 点 


前 面 已 经 对 开放 与 封 财 原则 的 “对 于 修改 是 封 财 的 ”规则 做 了 泣 清 ,下面 开 始 讲解 “对 于 扩 
展 是 开放 的 ”这 个 规则 。 应 用 了 开放 与 封闭 原则 的 类 应 该 通过 定义 扩展 点 来 对 扩展 保持 开放 ， 这 
些 现 有 代码 上 的 扩展 点 可 以 在 将 来 引入 新 的 功能 以 提供 新 的 行为 。 

本 六 会 详细 讲解 一 些 不 同类 的 扩展 点 及 其 优 缺 点 。 本 章 会 在 前 一 章 使 用 的 TradeProcessor 
类 的 示例 上 继续 讲解 ， 讲 解 的 重点 是 客户 端 代 码 和 该 类 的 交互 。 


6.2.1 没有 扩展 点 的 代码 














首先 ， 没 有 扩展 点 的 代码 是 什么 样子 的 呢 ? 图 6-1 展 示 了 没有 扩展 点 的 类 需要 添加 新 功能 时 


TradeProcessorClient TradepProcessorClient 


的 状况 。 


-tradeProcessor -tradeProcessor 


TradeProcessor 





1 
一 I 
1 


vy 
TradeProcessorVersion2 


+ProcessTrades() 





+ProcessTrades() 


图 6-1 如 果 没 有 扩展 点 ， 则 会 强制 客户 端 进行 更 改 


TradeProcessorClient 类 直接 依赖 TradeProcessor 类 。 当 你 接 到 一 个 需要 改动 Trade- 
Processor 类 的 新 需求 时 ， 为 了 不 改变 原 有 类 型 ， 创 建 了 一 个 新 版 本 (TradeProcessor- 
Version2 ) 来 包含 新 需求 提出 的 新 功能 。 客 户 端 直 接 依赖 TradeProcessor 类 并 且 该 类 没有 提供 
任何 扩展 点 ， 因 此 你 需要 将 新 功能 安排 在 新 的 类 中 。 这 种 改动 的 副作用 就 是 ， 必 须 改 动 
TradeProcessorClient 类 ， 这 样 才 能 依赖 新 的 TradeProcessorversion2 类 。 

如 果 对 现 有 代码 的 改动 不 会 影响 客户 端 ， 你 也 许 就 不 需要 再 创建 一 个 全 新 的 
TradeProcessor 类 了 了。 如果 要 改变 的 是 ProcessTrades 方 法 的 签名 ， 那 这 就 不 是 简单 的 对 类 实 
现 的 改动 ， 而 是 对 接口 的 改动 了 。 因 为 客户 端 总 是 与 服务 的 接口 紧密 耦合 的 , 所 以 任何 接口 上 的 
改动 都 会 引起 客户 端 代码 的 改动 。 
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6.2.2” 虚 方法 


TradeProcessor 类 的 另外 一 种 实现 包含 了 一 个 扩展 点 : ProcessTrades 是 个 虚 方 法 。 图 6-2 
展示 了 使 用 虚 方 法 后 的 三 个 类 的 关系 。 


TradeProcessorClient 


-tradeProcessor 


TradeProcessor 


+ProcessTrades(): virtual 


TradeProcessorVersion2 


+ProcessTrades(): override 





图 6-2 ”客户 端 依赖 TradeProcessor 类 ， 该 类 可 以 通过 继承 进行 扩展 


任何 带 有 一 个 虚 方 法 成 员 的 类 都 是 对 扩展 开放 的 。 这 种 扩展 是 通过 实现 继承 做 到 的 。 当 
TradeProcessor 类 的 新 特性 需求 到 来 时 ， 你 可 以 修改 其 子 类 的 ProcessTrades 方 法 而 无 需 改变 
原 有 的 TradeProcessor 类 源 代 码 。 

此 时 的 TradeProcessorClient 不 需要 做 改动 ， 因为 你 可 以 使 用 多 态 向 客户 端 提 供 新 版 本 的 
TradeProcessorVersion2 类 的 实例 并 使 其 调用 该 实例 的 ProcessTrades 方 法 。 

然而 ,你 能 重新 实现 的 范围 是 有 一 定 限制 的 。 在 新 的 子 类 中 ,你 依然 能 够 访问 基 类 ， 因 此 可 
以 直接 调用 TradeProcessor 类 的 ProcessTrades 方 法 ， 但 是 无 法 改动 该 方法 内 的 任何 代码 。 你 
要 么 在 子 类 方法 里 调用 基 类 同名 方法 并 且 在 其 前 或 后 实现 新 的 特性 , 要 么 你 完全 重新 实现 子 类 的 
方法 。 虚 方法 并 没有 中 间 状 态 。 记 住 ， 子 类 只 能 访问 基 类 的 受 保护 和 公共 成 员 。 如 果 
TradeProcessor 类 带 有 很 多 你 无 权 访问 的 私有 成 员 ， 你 就 需要 修改 该 基 类 的 实现 了 ， 当 然 ， 这 
样 就 会 违 彰 开放 与 封 财 原则 。 


6.2.3 ”抽象 方法 
男 外 一 种 使 用 实现 继承 的 更 加 灵活 的 扩展 点 是 抽象 方法 。 在 这 种 情况 下 ,，TradeProcessor 
类 是 一 个 定义 了 公共 ProcessTrades 方 法 的 抽象 类 , 该 方法 会 委托 三 个 抽象 的 保护 方法 来 完成 交 


易 处 理 算法 的 工作 ,客户 端 对 这 三 个 保护 方法 并 不 知情 ,因为 它们 都 是 没有 具体 实现 的 抽象 方法 。 
图 6-3 展 示 了 相关 类 的 关系 。 
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TradeProcessorClient 


<<ABSTRACT> > 
TradeProcessorAbstract 


+ProcessTrades() 
-GetTradeData(): abstract 
-Parse(): abstract 
-Persist(): abstract 








TradeProcessorVersion2 





TradeProcessor 


+ProcessTradesO +ProcessTradesO 
-GetTradeData(): override -GetTradeData(): override 


-Parse(): override -Parse(): override 
-Persist(): override -Persist(): override 


图 6-3 ”抽象 方法 为 将 来 的 子 类 提供 了 扩展 点 


示例 中 提供 了 两 个 版 本 的 交易 处 理 器 。 它 们 都 从 抽象 基 类 中 直接 继承 了 ProcessTrades 方 
法 , 也 都 为 三 个 抽象 方法 提供 了 各 自 的 实现 。 客 户 端 依赖 抽象 基 类 ， 因 此 提供 任何 一 个 具体 子 类 
(或 者 用 来 支持 新 需求 的 新 子 类 ) 给 客户 端 都 不 会 违背 开放 与 封闭 原则 。 

这 也 是 模板 方法 模式 ( Template Method pattern ) 的 一 个 示例 。 该 模式 只 对 算法 框架 建 模 ， 而 
算法 的 每 个 具体 步骤 还 可 以 自 定义 , 因为 它们 都 是 委托 抽象 方法 来 完成 具体 动作 的 。 实际 上 ， 基 
类 委托 子 类 来 处 理 每 个 具体 的 步骤 。 








6.2.4 接口 继承 


本 草 讨 论 的 最 后 一 个 扩展 点 是 实现 继承 外 的 另外 一 种 选项 : 接口 继承 。 这 里 ,客户 端 委托 接 
口 取代 了 客户 端 对 类 的 依赖 。 图 6-4 展 示 了 客户 端 对 接口 的 依赖 以 及 该 接口 的 两 个 实现 。 

接口 继承 要 比 实现 继承 好 很 多 。 基 于 实现 继承 ,所 有 子 类 ( 现 有 的 和 将 来 的 ) 都 是 基 类 的 客 
户 症 。 这 会 影响 后 续 的 修改 ,因为 子 类 也 都 是 依赖 基 类 实现 的 。 因此， 所 有 对 实现 的 改动 都 会 是 
客户 端 可 能 察觉 到 的 改动 。 因 此 相对 于 继承 ， 通 常会 建议 优先 选择 组 合 ， 如 果 必 须要 使 用 继承 ， 
也 要 尽量 使 用 只 有 少量 分 层 的 浅 继承 层次 结构 。 给 继承 图 顶部 广 点 添 加 新 成 员 的 改动 会 影响 到 该 
层次 结构 下 的 所 有 成 员 。 

接口 也 是 一 个 比较 好 的 扩展 点 , 因为 可 以 根据 不 同 的 上 下 文 给 接口 修饰 丰富 的 功能 。 接口 要 
比 类 灵活 得 多 。 虽然 这 并 不 代表 类 继承 的 虚 方 法 和 抽象 方法 提供 的 扩展 点 没有 一 点 用 处, 但 是 它 
们 的 确 无 法 提供 与 接口 一 样 强大 的 自 适应 能 
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TradeProcessorClient 


+ProcessTrades() +ProcessTrades() 
-GetTradeData() -AuditTradeData() 
-Parsel() -ListErrors() 
-Persist() 





图 6-4 客户 端 依赖 接口 而 不 是 类 


6.2.5 “为 继承 设计 或 禁止 继承 ” 


Joshua Bloch 在 他 的 著作 《Effective Java 中 文 版 (第 2 版 )》 中 对 继承 的 描述 如 下 所 示 。 
为 继承 设计 和 撰写 文档 ， 或 者 禁止 使 用 继承 。 

如 有 果 你 选择 使 用 实现 继承 作为 扩展 点 , 就 必须 恰当 地 设计 该 类 并 为 此 编写 清楚 的 文档 , 以 便 
让 后 续 要 扩展 该 类 的 编程 人 员 清 楚 原 始 的 设计 。 类 的 继承 会 比较 复杂 ,因为 新 的 子 类 会 以 一 种 不 
可 预期 的 方式 破坏 现 有 代码 。 

切记 ， 任 何 没有 标记 sealed 关 键 字 的 类 都 提供 了 继承 能 力 。 类 并 不 是 必须 要 有 虚 方法 或 者 
抽象 方法 才能 够 派生 子 类 。 使 用 new 关 键 字 可 以 隐藏 被 继承 的 成 员 , 但 是 这 种 方式 会 影响 多 态 能 
力 的 使 用 ， 显 然 违 背 了 我 们 的 期 望 。 

通过 密封 类 可 以 清楚 地 告诉 其 他 可 能 使 用 该 类 的 编程 人 员 : 该 类 并 不 支持 继承 。 这样 他 们 就 
会 重新 寻找 替代 方案 。 





6.3 ”防止 变异 


现在 你 已 经 有 了 好 几 个 能 实现 开放 与 封 朵 原则 的 工具 了 。 你 清楚 何 种 场合 下 可 以 修改 现 有 代 
码 , 你 也 知道 需要 在 你 的 代码 中 实现 扩展 点 以 便 支持 将 来 的 需求 变更 。 你 还 知道 可 以 使 用 接口 作 
为 扩展 点 来 让 你 的 代码 变 得 真正 具有 自 适 应 能 力 ， 其 至 可 以 应 对 将 来 的 考验 。 

我 们 还 没有 讲解 到 应 用 开放 与 封闭 原则 的 时 机 和 场合 。 极端 地 想 , 你 应 该 到 处 都 留 着 扩展 点 
吗 ? 这 样 做 会 让 你 的 代码 变 得 无 限 灵活 ， 还 是 应 用 效果 会 逐渐 递减 ? 
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下 面 是 为 外 一 个 跟 开放 与 封闭 原则 相关 的 重要 准则 : 防止 变异 (protected variation )。 这 是 
Alistair Cockburn 提 出 的 一 个 术语 。 
识别 可 预见 的 变化 点 并 围绕 它们 创建 一 个 稳定 的 接口 。 
该 原则 本 刁 叫 作 防 止 变异 ， 而 上 面 的 定义 引用 了 术语 可 预见 的 变化 (predicted variation )， 这 
多 少 会 让 人 产生 一 些 疑 惑 。 尽 管 如 此 ， 我 脑海 里 中 仍然 认为 “可 预见 的 变化 ”会 更 加 合适 一 些 。 
接 下 来 会 详细 讲解 该 定义 的 两 个 方面 。 


6.3.1 可 预见 的 变化 


单个 类 的 需求 应 该 直接 与 客户 端的 一 个 业务 需求 天 联 起 来 。 如 果 忽 略 了 这 种 关联 , 这 个 类 就 
很 有 可 能 不 是 在 为 客户 端 要 求 的 业务 目标 服务 的 。 冲 刺 过 程 中 , 开发 人 员 从 冲刺 积压 工作 上 去 除 
用 户 故 事 , 然后 与 产品 负责 人 沟通 故事 相关 的 事情 。 此 时 ,开发 人 员 就 可 以 提出 有 关 将 来 的 、 洪 
在 的 相关 需求 。 这 样 构造 得 到 的 可 预见 变化 是 可 以 直接 转化 为 扩展 点 的 。 

















6.3.2 一 个 稳定 的 接口 


即使 你 只 委托 接口 ， 客 户 端 仍然 依赖 这 些 接口 。 如 果 接 口 发 生变 化 ,客户 端 也 必须 做 相应 的 
改动 。 依 赖 接口 的 最 大 优势 是 接口 变化 的 可 能 性 要 比 实现 小 很 多 。 如 果 你 按照 阶梯 模式 将 接口 和 
实现 分 别 组 织 在 不 同 的 程序 集中 , 那么 二 者 能 够 独立 变化 而 不 相互 影响 , 而 且 实 现 的 变动 也 不 会 
影响 到 接口 的 客户 端 。 

显然 , 用 于 表达 扩展 点 的 所 有 接口 应 该 是 稳定 的 ,这 一 点 非常 重要 。 接 口 改变 的 可 能 性 和 频 
率 应 该 很 低 ， 否 则 你 会 需要 通知 所 有 客户 端 使 用 新 版 本 的 接口 了 。 


6.3.3 ”足够 的 自 适 应 能 力 


只 在 合适 的 位 置 上 包含 恰当 数目 的 扩展 点 的 代码 也 被 称 为 代码 的 “ 宜 居 带 ”， 它 能 适应 代码 
后 续 的 变更 需求 ,同时 又 不 会 增加 复杂 度 和 过 度 设计 方案 。 对 于 任何 具体 问题 而 言 ， 代 码 的 自 适 
应 能 力 要 么 不 够 要么 过 度 ， 要么 正好 。 

大 多 数 编程 “新 手 ” 通常 会 以 过 程 化 方式 编码 , 即使 使 用 的 是 诸如 C# 等 支持 面向 对 象 的 语言 。 
他 们 会 习惯 将 类 看 作 方 法 的 聚集 地 ,而 不 管 这 些 方法 在 职责 上 是 否 真 的 应 该 在 一 起 。 他们 几乎 不 
做 架构 就 直接 编码 ， 代 码 中 也 没有 和 多少 扩 展 点 ( 即使 有 ， 也 都 没 用 对 地 方 )。 任 何 需求 变更 都 会 
直接 导致 对 现 有 类 代码 的 修改 。 第 $ 章 开篇 给 出 的 原始 TradeProcessor 类 就 是 这 些 “ 新 手 ” 们 党 
见 的 产 出 。 若 要 使 用 那个 原始 类 ， 你 就 必须 要 “精通 ” 那 段 代码 相关 的 一 切 信 息 。 

尽管 如 此 ， 有 时 采取 这 种 简单 的 实现 也 不 算 错 。 如 果 你 在 评估 了 一 个 诸如 TradeProcessor 
之 类 的 小 工具 应 用 程序 后 认为 它 儿 乎 不 会 再 发 生 任何 改变 , 那么 原始 版 本 的 过 程 化 实现 代码 就 足 
够 了 。, 在 原始 版 本 上 针对 清晰 度 重 构 后 的 新 版 本 很 可 能 也 可 以 满足 需求 。 如 有 果 你 根本 不 打算 对 此 
进行 扩展 , 那么 针对 抽象 的 重 构 所 付出 的 努力 将 是 不 值得 的 。 而 且 重 构 后 的 代码 实现 会 隐藏 在 接 
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口 后 并 且 布 局 在 多 个 文件 和 程序 集中 ， 从 而 导致 代码 在 一 定 程度 上 不 那么 直观 可 读 。 

另 一 种 极端 情况 是 ， 刚 刚 喜 欢 上 抽 和 象 的 编程 “老手 ”会 符 试 到 处 应 用 手中 这 个 强大 的 工具 。 
他 们 编写 的 代码 总 是 有 很 多 扩展 点 ， 而 绝 大 多 数 根本 就 不 会 被 用 到 。 为 了 提供 这 么 多 的 扩展 点 ， 
他 们 总 是 在 编码 过 程 中 花费 大 量 的 精力 组 织 代码 和 委托 责任 给 接口 。 

如 果 把 上 面 的 “新 手 ” 和 “老手 ”的 编码 风格 结合 一 下 ， 可 能 编写 出 更 加 和 谐 的 中 间 代 码 ， 
这 些 代码 中 有 足够 的 扩展 点 , 但 这 些 扩展 点 只 针对 那些 需求 不 清楚 、 不 稳定 或 难以 实现 的 代码 区 
域 。 然而, 要 有 丰富 的 经 验 积 崇 才能 做 到 这 一 点 ， 要 经 历 知 之 其 少 的 “新 手 ” 和 以 为 无 所 不 知 的 
“老手 ”阶段 后 ， 才 能 逐渐 精通 防止 变异 的 精髓 ， 并 进 阶 到 真正 高 手 的 层次 。 








6.4 ”总 结 


开放 与 封闭 是 一 个 面向 类 和 接口 设计 的 整体 原则 , 它 指导 开发 人 员 如 何 才能 编写 出 很 好 地 自 
适应 变更 的 代码 。 每 个 冲刺 部 需要 拥抱 那些 不 期 而 至 的 新 需求 。 然 而 ,承认 并 接受 变更 只 是 解决 
问题 的 第 一 步 。 如 果 你 的 代码 直到 出 现 变更 时 才 发 现 它 并 没有 为 变更 做 好 准备 ,此 时 为 了 适应 变 
更 要 做 的 工作 会 更 困难 、 更 费时 、 更 易 出 错 ， 代 价 也 更 高 。 

通过 确保 代码 对 扩展 开放 以 及 对 修改 封闭 , 你 有 效 地 阻止 了 后 期 变化 对 现 有 类 和 程序 集 的 修 
改 ， 因 为 后 面 的 编码 人 员 只 能 在 你 预 留 的 扩展 点 上 挂靠 新 创建 的 类 。 可 用 的 扩展 点 主要 有 两 种 : 
实现 继承 和 接口 继承 。 虚 方法 和 抽象 方法 允许 你 创建 子 类 来 定制 基 类 的 方法 。 如果 你 选择 将 类 委 
托 给 接口 ， 那 就 可 以 应 用 很 多 优秀 的 模式 来 更 加 灵活 地 创建 和 使 用 扩展 点 。 

尽管 如 此 ， 只 知道 要 在 代码 中 预 留 扩展 点 是 不 够 的 ， 你 还 需要 知道 应 用 它们 的 恰当 时 机 。 
防止 变异 的 概念 建议 你 先 识别 出 很 可 能 发 生变 更 的 需求 或 者 实现 起 来 特别 麻烦 的 代码 部 分 ， 然 
后 将 它们 隐藏 在 扩展 点 之 后 。 代 码 可 以 很 死板 ， 几 乎 无 法 扩展 和 细 化 ; 代码 也 可 以 很 流畅 ， 珊 
有 足够 的 准备 应 对 新 需求 的 大 量 扩展 点 。 两 种 选择 并 没有 对 错 ， 只 是 要 根据 具体 的 场景 和 上 下 
文 进行 应 用 。 

















Liskov 蔡 换 原 则 





完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 理解 Liskov 蔡 换 原 则 的 重要 性 。 

口 避免 违背 Liskov 替 换 原则 的 规则 。 

口 进一步 巩固 你 的 单一 职责 原则 和 开放 与 封闭 原则 的 习惯 。 
口 创建 遵守 基 类 契约 的 派生 类 。 

D 使 用 代码 巢 约 来 实现 前 置 条 件 、 后 置 条 件 以 及 数据 不 变 式 。 
口 编写 正确 引发 异 第 的 代码 。 

口 理解 协 变 、 逆 变 和 不 变性 并 知道 它们 的 应 用 场合 。 








7.1 Liskov 替换 原则 介绍 


Liskov 替 换 原 则 (Liskov Substitution Principle，LSP ) 是 一 组 用 于 创建 继承 层次 结构 的 指导 
原则 。 按 照 Liskov 蔡 换 原 则 创建 的 继承 层次 结构 中 ， 客 户 端 代码 能 够 放心 地 使 用 它 的 任意 类 或 子 
类 而 不 担心 影响 所 期 望 的 行为 。 
如 果 不 遵 守 Liskov 蔡 换 原 则 的 规则 ， 对 一 个 类 层次 结构 的 扩展 (也 就 是 说 ， 增 加 一 个 新 的 子 
类 ) 很 可 能 迫使 所 有 使 用 基 类 或 接口 的 客户 端 代码 也 要 做 相应 的 改动 。 相反 ,如果 严格 遵守 Liskov 
蔡 换 原则 的 规则 ,客户 端 将 无 法 看 到 对 类 层次 结构 所 做 的 任何 改动 。 只 要 接口 保持 不 变 ， 就 应 该 
没有 理由 改动 任何 已 有 的 客户 端 代码 。 因 此 ，Liskov 替 换 原则 也 辅助 增强 了 开放 与 封闭 原则 和 单 
一 职员 原则 的 应 用 效果 。 











7.1.1 正式 定义 
Liskov 替 换 原 则 的 正式 定义 是 由 杰出 的 计算 机 科学 家 Barbara Liskov 给 出 的 。 因 为 该 定义 非常 
简短， 所 以 这 里 需要 做 进一步 的 详解 。 下 面 是 Liskov 蔡 换 原 则 的 正式 定义 。 


如 果 S 是 T 的 子 类 型 ， 那 么 所 有 T 类 型 的 对 象 都 可 以 在 不 破坏 程序 的 情况 下 被 S 类 型 
的 对 象 替换 。 


定义 中 有 三 个 与 Liskov 蔡 换 原 则 相关 的 代码 要 素 。 
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口 基 类 型 : 客户 引用 的 类 型 (T )。 子 类 型 可 以 重 写 (或 部 分 定制 ) 客户 所 调用 的 基 类 的 任 
意 方 读 ， 

口子 类 型 :继承 自 基 类 型 (TT) 的 一 组 类 (S ) 中 的 任意 一 个 。 客 户 端 不 应 该 ， 也 不 需要 知 
道 它 们 在 实际 调用 哪个 具体 的 子 类 型 。 无 论 使 用 的 是 哪个 子 类 型 实例 ， 客 户 端 代 码 所 表 
现 的 行为 都 是 一 样 的 。 

口 上下文 : 客户 端 和 子 类 型 交互 的 方式 。 如 果 客 户 端 不 和 子 类 型 交互 ， 就 谈 不 上 是 否 违背 
或 遵守 了 Liskov 和 替换 原则 。 


7.1.2 Liskov 替换 原则 的 规则 


要 应 用 Liskov 符 换 原 则 就 必须 还 守 几 个 规则 。 这 些 规则 可 以 划分 为 两 类 : 契约 规则 (与 类 的 
期 望 有 关 ) 和 变 体 规则 ( 与 代码 中 能 被 蔡 换 的 类 型 有 关 )。 

1. 契约 规则 

这 些 规 则 与 子 类 型 的 契约 及 其 相应 的 约束 相关 。 

口 子 类 型 不 能 加 强 前 置 条 件 。 

口 子 类 型 不 能 削弱 后 置 条 件 。 

口 子 类 型 必须 保持 超 类 型 中 的 数据 不 变 式 〈 不 变 式 是 一 个 必须 保持 为 真 的 条 件 )。 

为 了 理解 这 些 契 约 规则 , 你 必须 先 理解 契约 的 概念 , 然后 再 弄 清楚 在 创建 子 类 型 时 确保 遵守 
这 些 规则 需要 做 的 事情 。 稍 后 的 7.2 节 将 会 深入 讨论 这 两 方面 。 

2. 变 体 规则 

这 些 规则 与 方法 的 参数 及 返回 类 型 相关 。 

口 子 类 型 的 方法 参数 类 型 必须 是 支持 逆 变 的 。 

口子 类 型 的 返回 类 型 必须 是 支持 协 变 的 。 

口 子 类 型 不 能 引发 不 属于 已 有 异常 层次 结构 中 的 新 异常 。 

支持 Microsoft .NET Framewotk 的 公共 语言 运行 时 的 语言 的 类 型 变 体 的 概念 只 局 限于 泛 型 和 委 
托 。 尽 管 如 此 ， 这 些 场 景 下 的 变 体 依然 是 值得 好 好 探讨 的 ， 这 是 你 必 不 可 少 的 知识 武器 ， 这 样 才 
可 以 为 类 型 的 变 体 编 写 出 符合 Liskov 蔡 换 原 则 的 代码 。 稍 后 的 7.3 节 会 深入 讨论 这 个 主题 。 




















7.2 ”契约 


我 们 经 稼 会 说 , 开发 人 员 应 该 面向 接口 编程 或 面向 赣 约 编程 。 然 而 , 除了 表面 上 的 方法 签名 ， 
接口 所 表达 的 只 是 一 个 不 够 严谨 的 契约 概念 。 如 图 7-1 所 示 ， 只 从 方法 的 签名 很 难看 到 很 多 与 实 
际 需求 以 及 方法 实现 保证 相关 的 信息 。 在 诸如 C# 之 类 的 强 类 型 化 编程 语言 中 , 至 少 都 有 给 参数 传 
递 正确 类 型 的 概念 ， 但 是 接口 距离 真正 的 契约 还 很 远 。 

所 有 方法 至 少 有 一 个 可 选 的 返回 类 型 、 一 个 名 称 和 一 个 可 选 的 正式 参数 的 列表 。 每 个 参数 都 
由 一 个 具体 类 型 和 名 称 组 成 。 在 调用 图 7-1 中 展示 的 方法 时 ， 你 知道 ( 只 从 方法 签名 上 看 ) 需要 


传 入 三 个 参数 ,一 个 类 型 是 float, 一 个 类 型 是 size<float>, 男 外 一 个 类 型 是 RegionInfo。 你 
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也 知道 可 以 将 类 型 为 decimal1 的 返回 值 保存 到 一 个 变量 中 或 在 调用 结束 后 操作 该 返回 值 。 





decimal CalculateShippingCost( 


float packageWeightInKilograms, 
参数 关 型 | Size<fLoat> packageDimensionsInInches ,上 参数 名 称 
RegionInfo destination) 


图 7-1 ”从 方法 签名 只 能 看 到 与 实现 期 望 相关 的 信息 


注意 ”图 7-1 中 使 用 decimal 类 型 来 表示 贷 币值 是 不 可 取 的 ， 而 应 该 使 用 Money 值 类 型 。 尽 
管 我 已 经 努力 确保 本 书 中 尽 可 能 多 的 示例 都 不 是 与 现实 世界 的 上 下 文 无 关 的 自 造 概念 , 但 仍 
有 一 些 地 方 为 了 简洁 而 做 出 了 妥协 。 


作为 方法 编写 者 , 你 能 控制 方法 和 参数 的 名 称 。 你 要 特别 用 心地 确保 方法 名 称 能 反映 出 它 的 
真实 目的 ， 同 时 参数 名 称 要 尽 可 能 是 描述 性 的 。Calcu1lateSshippingCost 函 数 的 名 称 使 用 了 动 
名 词组 的 形式 。 这 里 的 动词 ( 由 方法 执行 的 动作 ) 是 Calculate， 名 词 ( 动词 的 对 象 ) 是 
ShippingCost。 在 某 种 意义 上 ， 这 个 名 词 就 是 返回 值 的 名 称 。 参 数 也 选择 了 描述 性 的 名 称 : 
packageDimensionsInInches 和 packageweightInKilorams 都 是 自 解释 的 参数 名 称 , 特别 是 在 
该 方法 的 上 下 文中 。 它 们 构成 了 方法 文档 化 的 开端 。 








提示 想 了 解 更 多 有 关 好 的 变量 和 方法 命名 ， 以 及 其 他 最 佳 实 践 ，Steve McConnell 的 Code 
Complete“ 一 书 是 一 个 很 好 的 选择 。 


然而 ， 方 法 签名 并 没有 包含 方法 的 契约 信息 。 比 如 ，packageweightInKil1ograms 人 参数 是 
float 类 型 的 。 这 就 暗示 客户 端 任何 float 值 都 是 有 效 的 ， 包 括 负 数值 。 但 是 因此 参数 表达 的 是 
重量 ,所 以 负数 值 应 该 是 无 效 的 。 方 法 的 契约 应 当 强 制 要 求 重 量 值 必须 大 于 去。 为 了 保证 做 到 这 
一 点 ， 方 法 必须 要 实现 一 个 前 置 条 件 。 





提示 “尽管 本 章 中 概要 地 讲解 到 的 契约 能 够 在 运行 时 阻止 很 多 对 方法 的 无 效 调 用 ， 但 良好 
的 方法 和 参数 名 称 仍然 不 可 或 缺 。 比 如 ， 如 果 CalculateShippingCost 方 法 的 正式 参数 并 
没有 说 明 它 们 的 计量 单位 是 英寸 或 者 千克 , 客户 端 很 可 能 会 在 调用 该 方法 时 传 入 以 厘米 和 磅 
为 计量 单位 的 值 。 


GD http://moneytype.codeplex.com/。 
© http:/www.stevemcconnell.comy/cc.htm。 
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7.2.1 前 置 条 件 


前 置 条 件 ( precondition ) 是 一 个 能 保障 方法 稳定 无 错 运行 的 先决 条 件 。 所 有 方法 在 被 调用 前 
都 要 求 某 些 前 置 条 件 为 真 。 默 认 情 况 下 ， 接 口 并 没有 任何 对 方法 具体 实现 的 保障 。 代 码 清单 7-1 
给 你 展示 了 如 何在 方法 入 口 添加 防卫 子 句 来 实现 前 置 条 件 。 


代码 清单 7-1 引发 异常 是 一 种 强制 履行 奖 约 的 高 效 方式 


public decimal CalculateShippingCost( 
float packageWeightInKilograms, 
Size<float> packageDimensionsInInches, 
RegionInfo destination) 








if (packageWeightInKilograms <= 0f) throw new Exception() ; 


return decimal.MinusOne; 


} 











方法 入 口 处 的 话语 句 是 一 种 强制 设置 前 置 条 件 的 方式 ， 比 如 重量 必须 大 于 零 千 克 的 需求 。 如 
果 条 件 packageWeightInKilograms <= 0f 为 真 ， 方法 会 引发 一 个 异常 并 立即 结束 运行 。 这 种 
方式 肯定 可 以 阻止 方法 在 有 参数 无 效 的 情况 下 被 执行 。 通 过 使 用 一 个 更 具 描 述 性 的 异常 , 你 能 提 
供给 调用 者 更 多 上 下 文 信息 ， 如 代码 清单 7-2 所 示 。 


代码 清单 7-2 尺 可 能 提供 详尽 的 前 置 条 件 校 验 失败 原因 是 很 重要 的 


public decimal CalculateShippingCost( 
float packageWeightInKilograms, 
Size<float> packageDimensionsInInches, 
RegionInfo destination) 





if (packageWeightInKilograms <= 0f) 
throw new ArgumentOutOfRangeException("packageWeightInKilograms", "Package weight 
must be positive and non-zero"); 


return decimal.MinusOne; 


} 





新 的 异常 有 了 很 多 改进 , 它 的 名 称 解释 了 自己 的 目的 : 参数 超出 了 有 效 范 围 ， 而 有 旦 客户 端 能 
知道 是 哪个 参数 出 错 以 及 相应 的 问题 描述 。 

通过 像 这 样 将 更 多 的 防卫 子 句 链接 到 一 起 ， 你 可 以 添加 更 多 条 件 ， 这 些 条 件 是 为 了 调用 方 
法 而 不 引发 异常 所 必须 满足 的 条 件 。 代 码 清单 7-3 中 显示 的 更 改 也 包含 包 尺 寸 超出 范围 时 引发 的 
异常 。 
代码 清单 7-3 ”增加 足够 多 的 必要 前 置 条 件 可 以 防止 在 参数 无 效 的 情况 下 方法 被 调用 


public decimal CalculateShippingCost( 
float packageWeightInKilograms, 





Size<float> packageDimensionsInInches， 
RegionInfo destination) 


if (packageweightInKi lograms <= 0f) 
throw new ArgumentOutOfRangeException("packageWeightInKilograms", "Package weight 
must be positive and non-zero"); 


if (packageDimensionsInInches.X <= Of || packageDimensionsInInches.Y <= 0f) 
throw new ArgumentOutOfRangeException("packageDimensionsInInches”", "Package 


dimensions must be positive and non-zero"); 


return decimal .MinusOne ; 





如 果 有 了 这 些 前 置 条 件 ， 客 户 端 代码 就 必须 在 调用 方法 前 确保 它们 要 传递 的 参数 值 要 处 于 有 
效 范围 内 。 当 然 ， 所 有 在 前 置 条 件 中 检查 的 状态 必须 是 公开 可 访问 的 。 如 果 客 户 端 无 法 验证 由 于 
未 通过 前 置 条 件 检查 导致 将 要 调用 的 方法 引发 异常 ,客户 端 就 无 法 确保 接 下 来 的 调用 一 定 会 成 功 。 
因此 , 私有 状态 不 应 该 是 前 置 条 件 检 查 的 目标 , 只 有 方法 参数 和 类 的 公共 属性 才 应 该 有 前 置 条 件 。 


7.2.2 后 置 条 件 


后 置 条 件 ( postcondition ) 会 在 方法 退出 时 检测 一 个 对 象 是 否 处 于 一 个 无 效 的 状态 。 只 要 方 
法 内 改动 了 状态 ， 就 有 可 能 因为 方法 逻辑 错误 导致 状态 无 效 。 

与 实现 前 置 条 件 一 样 ， 可 以 使 用 防卫 子 句 来 实现 后 置 条 件 。 然而, 后 置 条 件 并 不 是 布置 在 方 
法 的 入 口 处 ， 而 是 必须 布置 在 所 有 的 状态 编辑 动作 之 后 的 方法 尾部 ， 如 代码 清单 7-4 所 示 。 


代码 清单 7-4 方法 尾部 的 临界 子 句 是 一 个 后 置 条 件 ， 它 能 确保 返回 值 处 于 有 效 范 围 内 


public virtual decimal CalculateShippingCost(float packageWeightInkKilograms, Size<float> 
packageDimensionsInInches, RegionInfo destination) 


{ 





























if (packageWeightInKilograms <= 0f) 
throw new ArgumentOutOfRangeException("packageWeightInKilograms", "Package weight 
must be positive and non-zero"); 


if (packageDimensionsInInches.X <= 0f || packageDimensionsInInches.Y <= 0f) 
throw new ArgumentOutOfRangeException("packageDimensionsInInches", "Package 
dimensions must be positive and non-zero"); 
// shipping cost calculation 
var shippingCost = decimal .One; 
ifCshippingCost <= decimal .Zero) 
throw new ArgumentOutOfRangeException("return", "The return value is out of 


range"); 


return shippingCost ; 
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通过 预先 定义 的 有 效 范 围 检查 状态 值 (如果 值 不 在 指定 范围 驶 引发 异常 )， 你 能 强制 方法 符 
合 一 个 后 置 条 件 。 上 面 示 例 中 的 后 置 条 件 与 对 象 的 状态 并 不 相关 ， 而 是 与 方法 返回 值 相关 。 像 方 
法 参数 要 经 过 前 置 条 件 检查 一 样 ,方法 的 返回 值 也 需要 经 过 后 置 条 件 的 校 验 。 如 果 方 法 中 任意 地 
方 将 返回 值 设置 为 零 或 者 负数 值 , 这 个 后 置 条 件 会 检测 到 它 并 在 方法 尾部 中 止 执 行 。 通 过 这 种 方 
式 ， 该 方法 的 客户 端 永远 无 法 在 意外 地 收 到 无 效 返回 值 时 还 能 认为 它 依然 有 效 。 注 意 ， 该 方法 的 
签名 无 法 保证 返回 值 必须 大 于 零 ， 要 达到 这 个 目的 ， 必 须 通 过 客户 端 履行 方法 的 契约 来 保证 。 

















7.2.3 数据 不 变 式 


第 三 种 类 型 的 契约 是 数据 不 变 式 。 数 据 不 变 式 〈 data invariant ) 是 在 一 个 对 象 生命 周期 内 始 
终 都 保持 为 真 的 一 个 谓词 ; 该 谓词 条 件 在 从 对 象 构 造 后 一 直到 超出 其 作用 范围 前 这 段 时 间 都 为 
真 。 数 据 不 变 式 都 是 与 期 望 的 对 象 内 部 状态 有 关 。ShippingStrategy 调 用 的 一 个 数据 不 变 式 的 
一 个 示例 是 : 提供 的 比例 税率 为 正 值 且 不 为 零 。 如 果 如 代码 清单 7-5 中 所 示 ， 在 构造 函数 中 设置 
比例 税率 ， 那 么 只 需要 在 构造 函数 入 口 处 增加 一 个 防卫 子 句 束 可 以 防止 将 其 设置 为 无 效 值 。 











代码 清单 7-5 ”给 构造 两 数 增加 前 置 条 件 能 够 保证 相应 的 数据 不 变 式 


public class ShippingStrategy 


{ 
public ShippingStrategy(decimal flatRate) 
{ 


if (flatRate <= decimal.Zero) 
throw new ArgumentOutOfRangeException("flatRate", "Flat rate must be positive 


and non-zero"); 


this.flatRate = flatRate; 
} 


protected decimal flatRate; 
} 





因为 flatRate 是 一 个 受 保护 的 成 员 变 量 ， 所 以 客户 端 只 能 通过 构造 函数 来 设置 它 。 如 果 传 
入 构造 函数 的 值 是 有 效 的 ， 这 就 保证 了 该 SshippingStrategy 类 实例 的 对 象 在 生命 周期 内 
flatRate 值 都 是 有 效 的 ， 因 为 客户 端 没有 其 他 方式 可 以 修改 它 。 

然而 ， 如 果 把 flatRate 定 义 为 公共 且 可 设置 的 属性 ， 为 了 保护 这 个 数据 不 变 式 ， 就 必须 
把 防卫 子 句 布置 到 属性 设置 需 内 。 人 代码 清单 7-6 展 示 了 重 构 为 公共 属性 的 FlatRate 和 相应 的 防 
了 地 何 8 


代码 清单 7-6” 当 数据 不 变 式 是 一 个 公共 属性 时 ， 防 卫 子 名 就 应 该 布置 在 它 的 设置 天 中 


public class ShippingStrategy 
{ 
public ShippingStrategy(decimal flatRate) 


{ 
FlatRate = flatRate; 





} 
public decimal FlatRate 
{ 

get 

{ 

return flatRate; 
set 
{ 


if (value <= decimal .Zero) 
throw new ArgumentOutOfRangeException("value", "Flat rate must be positive 
and non-zero"); 


flatRate = value; 


} 


现在 客户 端 能 够 改变 FlatRate 属 性 的 值 了 , 但 是 由 于 属性 设置 副 内 的 if 语 句 和 异常 的 保护 ， 
这 个 数据 不 变 式 是 无 法 被 破坏 的 。 


封装 与 契约 

虽然 该 示例 中 的 契约 实现 是 有 意义 的 , 但 这 里 为 每 个 值 选择 的 类 型 都 不 太 恰 当 。 为 了 确 
保 包 庄重 量 参数 的 数值 必须 大 于 零 而 引入 的 前 置 条 件 契 约 已 经 和 变量 的 类 型 本 质 有 了 关联 : 
重量 应 该 大 于 零 千 克 。 这 其 实 已 经 意味 着 应 该 为 重量 封装 一 个 专 有 的 类 型 了 了。 如果， 也 很 有 
可 能 ， 另 外 一 个 类 或 者 方法 也 需要 一 个 重量 值 ， 如 果 没 有 定义 类 ， 你 就 不 得 不 把 所 有 的 前 置 
条 件 语句 再 搬 到 新 的 实现 代码 中 。 这 样 做 效率 低 ， 难 维护 而 且 容 多 出 错 。 这 时 为 它 专门 定义 
一 个 包括 该 前 置 条 件 的 Weight 类 型 就 很 有 意义 了 ， 这 样 所 有 使 用 Weight 类 型 的 客户 端 都 必 
须 传 入 一 个 大 于 零 的 值 。 实 际 上 ，Weight 类 型 的 数据 不 变 式 要 比 CalculateShippingCost 
方法 中 的 前 置 条 件 更 好 。 

类 似 地 ， 使 用 decima1 类 型 对 比例 税率 建 模 也 不 是 很 好 。 相 反 ， 也 应 该 为 比例 税率 创建 
一 个 专 有 的 类 型 ， 该 类 型 包含 了 一 个 确保 数值 必须 大 于 零 的 数据 不 变 式 。 





7.2.4 Liskov 契约 规则 
前 面 讨论 的 方法 契约 仅仅 是 Liskov 替 换 原则 的 一 小 部 分 。Liskov 替 换 原则 设置 了 一 组 类 型 必 
须 继承 契约 的 规则 。 作 为 提醒 ， 下 面 再 次 列 出 了 Liskov 替 换 原 则 的 正式 定义 。 


如 果 S 是 T 的 子 类 型 ， 那 么 所 有 T 类 型 的 对 象 都 可 以 在 不 破坏 程序 的 情况 下 被 S 类 型 
的 对 象 替 换 。 


通过 这 个 定义 可 以 导出 以 下 与 契约 相关 的 指导 原则 (前面 一 市 也 介绍 过 )。 


196 第 7 章 Liskov 替换 原则 


口 子 类 型 不 能 加 强 前 置 条 件 。 

口 子 类 型 不 能 削弱 后 置 条 件 。 

口 子 类 型 必须 保持 超 类 型 中 的 数据 不 变 式 。 

如 果 你 在 基于 现 有 类 创建 子 类 时 遵守 了 所 有 这 些 规 则 , 那么 替换 性 将 会 在 你 处 理 契 约 时 得 到 
保留 。 

任何 时 候 创建 子 类 ， 都 能 带 有 所 有 组 成 父 类 的 方法 、 属 性 和 字段 。 当 然 , 也 包括 方法 和 属性 
设置 器 内 的 所 有 契约 。 所 有 前 置 条 件 、 后 置 条 件 和 数据 不 变 式 都 被 期 望 按照 父 类 中 的 相同 方式 保 
留 。 在 适当 的 时 候 ， 子 类 被 允许 重 写 父 类 的 方法 实现 ， 此 时 才 有 机 会 修改 其 中 的 契约 。Liskov 替 
换 原 则 明确 规定 一 些 变 更 是 被 禁止 的 , 因为 它们 会 导致 原来 使 用 超 类 实例 的 已 有 客户 端 代码 在 切 
换 至 子 类 时 必须 要 做 更 改 。 

1. 前 置 条 件 不 能 被 加 强 

当 子 类 重 写 包含 前 置 条 件 的 超 类 方法 时 , 它 绝 不 应 该 加 强 现 有 的 前 置 条 件 。 这样 做 很 可 能 会 
影响 到 那些 已 经 假设 超 类 为 所 有 方法 定义 了 最 严格 的 前 置 条件 契 约 的 客户 端 代 码 。 

代码 清单 7-7 显 示 添 加 了 新 的 Wor1dwideShippingStrategy。 由 于 它 与 shippingStrategy 
类 很 相似 ， 因 此 将 该 类 实现 为 后 者 的 子 类 。CalcuteShippingCost 方 法 被 重 写 后 ， 多 了 一 个 新 
防卫 子 句 , 作为 对 regionInfo 参 数 代表 的 包 于 目的 地 信息 进行 检查 。ShippingStrategy 类 并 没 
有 要 求 必须 提供 包 正 目的 地 信息 ， 但 是 子 类 Wor1dwideShippingStrategy 则 要 求 必须 提供 有 效 
的 包 庄 目的 地 参数 ， 否 则 它 就 无 法 正确 计算 出 包 庄 运输 到 目的 地 的 费用 。 


代码 清单 7-7 子 类 通过 增加 一 个 新 的 防卫 子 句 增强 了 前 置 条 件 


public class WorldwideShippingStrategy : ShippingStrategy 
{ 























public override decimal CalculateShippingCost( 
float packageWeightInKilograms, 
Size<float> packageDimensionsInInches ， 
RegionInfo destination) 


if (packageweightInKilograms <= 0Of) 
throw new ArgumentOutOfRangeException("packageWeightInKilograms", "Package 
weight must be positive and non-zero"); 


if (packageDimensionsInInches.X <= 0f || packageDimensionsInInches.Y <= 0f) 
throw new ArgumentOutOfRangeException("packageDimensionsInInches", "Package 
dimensions must be positive and non-zero"); 


if (destination == nul1) 
throw new ArgumentNullException("destination", "Destination must be 


provided"); 


return decimal.One; 


7.2 ”契约 197 


加 强 前 置 条 件 的 尝试 让 你 能 够 保证 得 到 有 效 的 目的 地 参数 , 但 这 会 引起 一 个 已 有 的 调用 代码 
无 法 解决 的 问题 。 如 果 某 个 类 调用 了 ShippingStrategy 类 的 CalculateShippingCost 方 法 , 它 
是 可 以 向 目的 地 参数 传人 空 值 且 不 担心 有 副作用 产生 。 但 是 ， 如 果 改 为 调用 wor1dwide- 
ShippingStrategy 类 的 CalculateShippingCost 方 法 后 , 它 就 必须 要 确保 传 给 目的 地 参数 的 值 
不 为 空 。 如 果 传 人 的 是 空 值 ， 就 会 违背 相应 的 前 置 条 件 要 求 并 且 会 引发 一 个 异常 。 正 如 前 面 几 章 
所 讲述 的 , 客户 端 代码 绝 不 应 该 假设 类 的 具体 行为 。 那样 做 只 会 在 客户 端 代码 和 类 之 间 引 入 紧密 
耦合 关系 ， 从 而 导致 缺乏 响应 需求 变更 的 能 力 。 

代码 清单 7-8 展 示 的 单元 测试 可 以 证 明 这 种 问题 。 


代码 清单 7-8 ” 当 加 强 前 置 条 件 时 ， 客 户 端 无 法 在 需要 ShippingStrategy 的 情况 下 可 靠 地 使 用 
WorldwideShippingStrategy 














[Test] 
public void ShippingRegionMustBeProvided() 
{ 
strategy.Invoking(s => s.CalculateShippingCost(1f, ValidDimensions, null)) 
.ShouldThrow<ArgumentNullException>("Destination must be provided") 
.And.ParamName. Should() .Be("destination"); 


如 果 该 测试 使 用 的 strategy 对 象 是 Wor1dWideShippingStrategy 类 的 实例 , 测试 的 结果 会 
是 成 功 的 ; 没有 提供 必要 的 目的 地 信息 ， 因 此 会 按照 期 望 引 发 一 个 异常 。 相 反 ， 如 果 使 用 的 是 
ShippingStrategy 类 实例 ， 该 测试 将 会 失败 ， 因 为 ShippingStrategy 类 的 方法 实现 中 并 没有 
前 置 条 件 来 检查 目的 地 值 是 否 为 空 ， 也 不 会 按照 测试 期 望 的 那样 在 检查 到 空 值 时 引发 异 销 。 

代码 清单 7-9 展 示 了 一 组 重 构 过 的 单元 测试 ， 它 们 并 不 尝试 对 这 两 种 不 同 的 类 测试 相同 的 前 
置 条 件 。 第 一 个 测试 只 在 Wor1dwideShippingStrategy 类 的 实例 上 断言 必须 提供 目的 地 信息 。 
然而 ,无论 是 什么 类 型 的 运输 策略 ， 要 求 运输 重量 必须 大 于 零 的 前 置 条 件 都 总 是 有 效 的 , 所 以 作 
为 基 类 的 第 二 个 测试 对 每 种 运输 策略 类 型 都 有 效 。 


代码 清单 7-9 重 构 后 的 单元 测试 分 别针 对 这 两 种 不 同 的 运输 策略 类 型 


[TestFixture] 
public class WorldwideShippingStrategyTests : ShippingStrategyTestsBase 
{ 




















[Test] 
public void ShippingRegionMustBeProvided() 
{ 
strategy.Invoking(s => s.CalculateShippingCost(1f, ValidSize, null)) 
.ShouldThrow<ArgumentNullException>("Destination must be provided") 
.And.ParamName. ShouldQO .Be("destination"); 
} 


protected override ShippingStrategy CreateShippingStrategy() 


{ 
return new WorldwWideShippingStrategy(decimal.One); 
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} 
} 
OA 
public abstract class ShippingStrategyTestsBase 
{ 
[Test] 
public void ShippingweightMustBePositive() 
{ 


strategy.Invoking(s => s.CalculateShippingCost(-1f, ValidSize, null)) 
.ShouldThrow<ArgumentOutOfRangeException>("Package weight must be positive and 
non-zero") 
.And.ParamName.Should() .Be("packageWeightInkKilograms"); 


} 
} 


2. 后 置 条 件 不 能 被 削弱 

在 向 子 类 应 用 后 置 条 件 时 ， 规 则 恰好 相反 。 不 是 不 能 加 强 后 置 条 件 ， 而 是 不 能 削弱 它们 。 对 
于 所 有 与 和 契约 相关 的 Liskov 替 换 规则 而 言 ， 你 不 能 够 削弱 后 置 条 件 的 原因 很 明显 ， 因 为 已 有 的 
客户 端 代码 在 从 原 有 的 超 类 切换 至 新 的 子 类 时 很 可 能 会 出 错 。 理论 上 ， 如 果 严 格 遵 守 了 Liskov 替 
换 原 则 ， 你 所 创建 的 任何 子 类 都 能 够 被 所 有 已 有 的 客户 端 代码 使 用 且 不 会 引起 意料 之 外 的 错误 。 

代码 清单 7-10 展 示 了 在 一 个 已 有 的 客户 端 代 码 中 引入 意外 失败 的 示例 ， 其 中 包括 了 与 
WorldwideShippingStrategy 类 相关 的 单元 测试 和 实现 ， 该 类 用 来 对 国际 包 里 运输 建 模 。 


代码 清单 7-10 ”新 的 实现 要 求 削 弱 后 置 条 件 


[Test] 
public void ShippingDomesticallyIsFree() 


{ 
strategy.CalculateShippingCost(1f, ValidDimensions, RegionInfo.CurrentRegion) 


.Should(O) .Be(decimal.Zero); 

















} 
/a 
public override decimal CalculateShippingCost(float packageWeightInKilograms, Size<float> 
packageDimensionsInInches, RegionInfo destination) 
{ 
if (destination == null) 
throw new ArgumentNullException("destination”", "Destination must be provided"); 


if (packageWeightInKilograms <= 0f) 
throw new ArgumentOutOfRangeException("packageWeightInKilograms", "Package weight 
must be positive and non-zero"); 


if (packageDimensionsInInches.X <= Of || packageDimensionsInInches.Y <= 0f) 
throw new ArgumentOutOfRangeException("packageDimensionsInInches", "Package 
dimensions must be positive and non-zero"); 


var shippingCost = decimal.One; 
if(destination == RegionInfo.CurrentRegion) 


{ 


shippingCost = decimal.Zero; 


} 


return shippingCost; 


} 





示例 中 的 单元 测试 用 来 在 当前 区 域 用 作 目 的 地 (也 就 是 本 地 运输 ) 时 断言 Wor1dwide- 
ShippingStrategy 类 不 会 对 此 次 运输 收费 。 这 也 在 方法 尾部 的 实现 中 有 所 体现 。 这 个 新 测试 再 





一 次 与 基 类 的 单元 测试 发 生 了 冲突 ， 原 有 的 测试 断言 是 : 方法 的 返回 值 必须 大 于 零 。 如 代码 清 
7-11 所 示 。 
代码 清单 7-11 原 有 的 单元 测试 会 在 使 用 Wor1dwideShippingStrategy 类 实例 时 失败 

[Test] 

public void ShippingCostMustBePositiveAndNonZero() 

{ 


strategy.CalculateShippingCost(1f, ValidDimensions, RegionInfo.CurrentRegion) 
.Should() .BeGreaterThan (Om); 














这 样 的 改动 很 容易 影响 已 经 对 运输 费用 值 有 所 假设 的 客户 端 代码 。 比 如 ,有 客户 端 已 经 根据 
ShippingStrategy 类 的 前 置 条 件 契 约 假设 了 运输 成 本 总 是 大 于 零 的 ， 然 后 该 客户 端 会 在 后 续 的 
计算 中 使 用 该 运输 成 本 。 当 切换 至 新 的 Wor1dwideShippingStrategy 类 时 ， 该 客户 端 却 突然 开 
始 不 断 地 对 所 有 本 地 订单 引发 DivideByZeroException 异 常 。 

如 果 你 遵守 Liskov 蔡 换 原 则 并 且 决 不 削弱 后 置 条 件 ， 就 不 会 引入 这 个 缺陷 。 

3. 数据 不 变 式 必须 被 保持 

在 创建 新 的 子 类 时 ,， 它 必须 继续 遵守 基 类 中 的 所 有 数据 不 变 式 。 这 里 很 容易 出 问题 ， 因 为 子 
类 有 很 多 机 会 来 改变 基 类 中 的 私有 数据 。 

代码 清单 7-12 会 回 到 本 章 前 面 使 用 的 数据 不 变 式 示 例 。 不 同 的 是 ， 这 里 的 示例 中 ， 
ShippingSrategy 类 通过 构造 函数 参数 接受 比例 税率 数值 并 且 将 其 保存 到 一 个 只 读 的 数据 不 变 
式 中 。 新 引入 的 wor1dwideshippingStrategy 类 将 比例 税率 改 为 一 个 公共 的 属性 。 


代码 清单 7-12” 子 类 破坏 了 超 类 的 数据 不 变 式 ， 因 此 也 违背 了 Liskov 符 换 原 则 


[Test] 
public void ShippingFlatRateCanBeChanged(Q) 
{ 











strategy.FlatRate = decimal.MinusOne; 


strategy.FlatRate.Should() .Be(decimal.MinusOne); 
} 
> 
public class WorldWwideShippingStrategy : ShippingStrategy 
{ 

public WorldwideShippingStrategy(decimal flatRate) 

: base(flatRate) 
{ 
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} 
public decimal FlatRate 
{ 
get 
{ 
return flatRate; 
set 
{ 
flatRate = value; 
} 
} 


} 








尽管 子 类 重用 了 基 类 的 构造 函数 及 其 防卫 子 句 , 但 它 并 没有 保护 好 原 有 的 数据 不 变 式 , 因此 
也 违背 了 Liskov 蔡 换 原 则 。 上 面 示例 中 的 单元 测试 可 以 证 明 客 户 端 能 够 设置 负数 值 。 如 采 该 类 能 
够 正确 地 保护 原 有 的 数据 不 变 式 ， 就 不 应 该 允许 将 比例 税率 设置 为 负数 值 。 

代码 清单 7-13 中 , 重 构 后 的 基 类 不 再 允许 直接 修改 比例 税率 字段 ， 它 的 子 类 也 正确 地 保持 了 
比例 税率 属性 这 个 数据 不 变 式 。 这 种 模式 非常 普 志 : 和 有 的 字段 有 对 应 的 受 保护 的 或 公共 的 属性 ， 
属性 的 设置 带 中 包含 的 防卫 子 句 用 来 保护 属性 相关 的 数据 不 变 式 。 


代码 清单 7-13 ” 基 类 只 允许 子 类 通过 包括 防卫 子 句 的 设置 胡来 修改 比例 税率 字段 


public class WorldwideShippingStrategy : ShippingStrategy 




















{ 
public WorldwideShippingStrategy(decimal flatRate) 
: base(flatRate) 
{ 
} 
public new decimal FlatRate 
{ 
get 
{ 
return base.FlatRate; 
set 
{ 
base.FlatRate = value; 
} 
} 
} 
7 
public class ShippingStrategy 
{ 


public ShippingStrategy(decimal flatRate) 
{ 
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if (flatRate <= decimal.Zero) 
throw new ArgumentOutOfRangeException("flatRate", "Flat rate must be positive 


and non-zero"); 


this.flatRate = flatRate; 


} 
protected decimal FlatRate 
{ 

get 

{ 

return flatRate,; 
set 
{ 


if (value <= decimal .Zero) 
throw new ArgumentOutOfRangeException("value", "Flat rate must be positive 


and non-zero"); 


flatRate = value; 


} 


在 严格 控制 了 字段 的 可 见 性 并 只 允许 通过 引入 防卫 子 句 的 属性 设置 带 访 问 该 字段 后 , 该 属性 
相关 的 数据 不 变 式 得 到 了 保护 。 对 子 类 层次 来 说 , 这 种 方式 也 是 值得 推荐 的 ， 因 为 这 意味 着 将 来 
所 有 的 子 类 部 不 再 需要 防卫 子 句 检查 ， 它 们 无 法 直接 改写 超 类 中 的 这 个 字段 。 

代码 清单 7-14 展 示 了 一 个 能 够 断言 这 文 个 新 行为 的 单元 测试 。 


代码 清单 7-14 在 维护 了 不 变 式 的 情况 下 ， 此 单元 测试 通 


[Test] 
public void ShippingFlatRateCannotBeSetToNegativeNumber() 


{ 




















strategy.Invoking(s => s.FlatRate = decimal.MinusOne) 
.ShouldThrow<ArgumentOutOfRangeException>("Flat rate must be positive and non- 


zero") 
.And.ParamName. Should() .Be("value"); 


} 


如 果 一 个 客户 端 尝 试 将 FlatRate 属 性 设置 为 负数 值 或 零 ， 设 置 磊 中 的 临界 子 句 会 阻止 赋值 
的 动作 并 且 引 发 一 个 ArgumentOutOfRangeException 异 常 。 


7.2.5 ”代码 契约 
上 一 节 通 篇 都 在 讲解 如 何 使 用 防卫 子 名 实现 最 基本 的 契约 。 但 是 由 于 使 用 if 语句 和 异常 手动 
构造 的 防卫 子 句 有 些 宛 长 ,因此 ,可 以 替代 临界 子 名 的 代码 契约 是 非常 值得 探讨 的 , 它 是 一 种 更 


好 的 契约 实现 方式 。 
在 NET Framework4.0 之 前 ，.NET 的 代码 契约 特性 被 组 织 在 一 个 独立 的 库 中 ， 直 到 4.0 才 被 集 
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成 到 了 主 库 mscorlib.dll 中 。 除 了 比 手动 临界 子 句 更 易 读 写 和 理解 外 ,代码 契约 还 提供 了 静态 验证 
以 及 自动 生成 参考 文档 的 特性 。 

通过 静态 契约 验证 , 代码 契 约 能 够 在 不 运行 应 用 程序 的 情况 下 检查 契约 的 履行 情况 。 这 种 方 
式 有 助 于 公开 空 引 用 和 数组 越界 等 隐 式 契约 以 及 本 节 中 要 讲解 的 各 种 显 式 编码 契约 。 

生成 方法 或 者 类 相关 的 参考 文档 非常 重要 , 因为 这 是 客户 端 能 够 了 解 契 约 期 望 信 息 的 唯一 途 
径 。 如 果 方 法 和 类 的 参考 文档 包含 了 足够 的 信息 ,那么 客户 端 就 可 以 通过 Visual Studio 提 供 的 智 
能 感知 特性 浏览 到 这 些 信 息 。 这 能 让 应 用 契约 的 类 型 更 易 用 一 些 。 

1. 前 置 条 件 

使 用 代码 契约 可 以 让 前 置 条 件 代 码 变 得 很 简洁 。 在 引用 mscorlib.dl 程 序 集中 的 
System.Diagnostics.Contracts 命 名 空间 后 ， 你 就 不 再 需要 引用 其 他 的 程序 集 了 。 其 中 的 
Contract 静 态 类 提供 了 实现 契约 所 需 的 主要 功能 。 








注意 ”如果 你 决定 好 采用 代码 契约 这 种 方式 ， 代 码 中 会 有 很 多 地 方 使 用 Contract 静 态 类 。 
这 倒 不 是 个 大 问题 ， 因 为 代码 契约 是 一 种 普遍 应 用 的 代码 基础 结构 ,通常 也 不 会 认为 要 移 除 
或 者 替换 它 。 但 是 ， 一 旦 应 用 之 后 再 想 剔 除 代码 契约 ， 工 作 量 就 会 非常 巨大 ， 所 以 最 好 在 一 
开始 就 做 好 决定 : 要 么 全 面 应 用 ， 要 么 根本 不 用 。 


代码 清单 7-15 展 示 了 代码 契约 前 置 条 件 的 声明 方式 。 


代码 清单 7-15 System.Diagnostics.Contracts 命 名 空间 能 够 为 方法 提供 防卫 子 名 


using System.Diagnostics.Contracts ; 


public class ShippingStrategy 
{ 
public decimal CalculateShippingCost(float packageWeightInKilograms, Size<float> 
packageDimensionsInInches, RegionInfo destination) 


{ 
Contract.Requires(packageWeightInKilograms > 0f); 
Contract.Requires(packageDimensionsInInches.X > 0f && packageDimensionsInInches.Y 
> 0 
return decimal.MinusOne; 
} 


} 


Contract.Requi res 方 法 接受 一 个 布尔 谓词 值 。 该 谓词 表示 方法 主体 逻辑 执行 前 需要 的 状 
态 。 注 意 , 这 与 手动 防卫 子 句 的 if 语 句 中 的 谓词 恰好 相反 。 手动 临界 子 句 会 在 状态 无 效 时 引发 异 
第 。 而 在 代码 契约 中 ,谓词 更 接近 于 单元 测试 中 的 断言 : 布尔 条 件 式 的 值 必须 为 真 ， 否则 就 违背 
了 契约 。 上 面 的 示例 要 求 packageweightInKi1ograms 参 数 必须 大 于 零 ，packageDimensions- 
InInches 参 数 的 X 和 Y 属 性 都 必须 大 于 零 。 

Contract.Requi res 方 法 会 在 契约 谓词 没有 得 到 满足 时 引发 一 个 异常 , 只 是 这 里 的 异常 类 为 
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ContractException， 这 与 前 面 示例 中 已 有 单元 测试 期 望 的 异常 类 不 相符 。 因 此 ,那些 已 有 的 
单元 测试 会 失败 。 
Expected System.ArgumentOutOfRangeException because Package dimension must be positive and non- 


zero, but found System.Diagnostics.Contracts._ ContractsRuntime+ContractEXxception with message 
"Precondition failed: packageDimensionsInInches.X > 0f && packageDimensionsInInches.Y > 0f" 


此 外 ， 如 果 在 运行 示例 代码 时 传 入 无 效 参数 ， 你 会 看 到 如 图 7-2 所 示 的 消息 窗口 。 这 些 信息 
通知 你 在 使 用 该 方法 前 应 该 首先 配置 好 代码 契约 。 





有 Thelnterface.vshost.exe - Precondition failed. 


Description: An assembly (probably "Thelnterface") must be rewritten using the code contracts 
binary rewriter (CCRewrite) because it is calling ContractRequires<TException> and the 
CONTRACTS_FULL symbol is defined, Remove any explicit definitions of the CONTRACTS_FULL 
symbol from your project and rebuild. CCRewrite can be downloaded from 
http://go.microsoft.com/fwlink/?LinklD=169180. 

After the rewriter is installed, it can be enabled in Visual Studio from the project's Properties 
page on the Code Contracts pane, Ensure that “Perform Runtime Contract Checking" is enabled, 
which will define CONTRACTS_FULL. 








© See details | Debug | Ignore | 











图 7-2 ”在 使 用 代码 契约 前 必须 做 好 配置 


Visual Studio 中 的 每 个 项 目 属性 都 包含 一 个 代码 契约 的 标签 页 ， 通 过 它 可 以 配置 项 目 代 码 奖 
约 相 关 的 设置 。 最 小 可 工作 的 设置 如 图 7-3 所 示 。 
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图 7-3 ”代码 契约 的 属性 页 面包 含 了 很 多 设置 项 


G@) 要 包含 这 个 代码 契约 的 配置 标签 页 ， 需 要 下 载 插 件 ， 网 址 为 : https://visualstudiogallery.msdn.microsoft.com/1ec7 
db13-3363-46c9-851f-1ce455f66970。 一 一 译 者 注 
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正确 配置 后 ， 就 可 以 使 用 另外 一 个 版 本 的 Contract .Requi res 方 法 来 编写 前 置 条 件 契 约 了 。 
如 代码 清单 7-16 所 示 。 


代码 清单 7-16 ”这 个 版 本 的 Requires 方 法 可 以 接受 指定 要 引发 的 异常 类 型 


public class ShippingStrategy 


{ 
public decimal CalculateShippingCost(float packageWeightInKilograms, Size<float> 


packageDimensionsInInches, RegionInfo destination) 


{ 
Contract.Requires<ArgumentOutOfRangeException>(packageWeightInkKilograms > 0Of， 
"Package weight must be positive and non-zero"); 
Contract.Requires<ArgumentOutOfRangeException>(packageDimensionsInInches.X > Of && 
packageDimensionsInInches.Y > 0f, "Package dimensions must be positive and non-zero"); 


return decimal.MinusOne; 


泛 型 Requi res 方 法 能 够 接受 在 谓词 不 为 真 时 你 想 要 引发 的 异常 类 型 。 上 面 示 例 中 指定 了 要 
引发 的 异常 类 型 以 及 第 二 个 参数 中 的 异常 信息 ， 这 样 就 应 该 可 以 通过 已 有 单元 测试 的 断言 了 。 

2. 后 置 条 件 

与 前 置 条 件 类 似 ， 代 码 契 约 也 为 定义 后 置 条 件 提 供 了 快捷 方法 。Contract 静 态 类 包含 的 
Ensures 方 法 就 是 用 来 实现 后 置 条 件 的 。 该 方法 同样 是 接受 一 个 必须 为 真 的 谓词 ， 以 便 继续 执 
行 到 方法 出 口 。 值 得 注意 的 是 ，Contract.Ensures 方 法 后 不 可 以 有 返回 语句 之 外 的 其 他 语句 。 
作 这 样 的 要 求 是 很 有 意义 的 ， 因 为 任何 返回 语句 之 外 的 后 续 代码 都 有 可 能 破坏 后 置 条 件 相 关 的 
状态 。 

代码 清单 7-17 展 示 了 ShippingCostMustBePositive 单 元 测试 以 及 使 用 Contract.Ensures 
方法 重 构 后 置 条 件 实现 后 的 CalculateShippingCost 方 法 。 


代码 清单 7-17 使 用 Ensures 方 法 创建 的 后 置 条 件 在 方法 出 口 时 应 该 为 真 


[Test] 
public void ShippingCostMustBePositive() 
{ 














strategy.CalculateShippingCost(1, ValidSize, null) 
.ShouldQO .BeGreaterThan(decimal.MinusOne); 
} 
OA 
public class ShippingStrategy 
{ 
public decimal CalculateShippingCost(float packageWeightInKilograms, Size<float> 
packageDimensionsInInches, RegionInfo destination) 
{ 
Contract.Requires<ArgumentOutOfRangeException>(packageWeightInKilograms > Of, 
"Package weight must be positive and non-zero"); 
Contract.Requires<ArgumentOutOfRangeException>(packageDimensionsInInches.X > Of && 
packageDimensionsInInches.Y > 0f, "Package dimensions must be positive and non-zero"); 


Contract.Ensures(Contract.Result<decimal>() > 0m); 


return decimal.MinusOne; 
} 
} 





这 个 示例 中 的 谓词 看 起 来 与 前 面 示例 中 的 谓词 不 同 , 也 与 常见 的 判断 返回 值 是 否 有 效 的 后 置 
条 件 使 用 方式 不 同 。 检 查 运 输 费 用 是 否 大 于 零 (实际 上 是 非 负 数 ) 需要 明白 返回 值 的 相关 信息 。 
返回 值 通 常会 , 但 并 不 总 是 会 , 声明 和 定义 在 方法 内 部 的 局 部 变量 。 你 可 以 谨 愤 地 断言 返回 的 值 
大 于 零 ， 但 是 这 并 不 像 你 想象 的 那样 简单 。 为 了 获取 从 方法 实际 返回 的 值 ， 你 需要 使 用 
Contract.Result 方 法 。 这 个 泛 型 方法 可 以 接受 方法 的 返回 值 类 型 并 返回 方法 最 终 退 出 时 刻 的 任 
意 结果 。 通过 Contract.Result 方 法 获取 契约 所 在 方法 的 最 终 返 回 值 , 你 就 能 确保 在 后 置 条 件 语 
名 后 没有 任何 代码 能 在 不 引起 失败 异常 的 情况 下 将 返回 值 替换 为 无 效 值 。 

3. 数据 不 变 式 

通常 类 中 的 每 个 方法 都 包含 自己 的 前 置 条 件 和 后 置 条 件 ， 但 数据 不 变 式 是 针对 类 整体 的 契 
约 。 代 码 契 约 允 许 你 在 类 内 创建 一 个 私有 的 方法 来 声明 和 定义 针对 类 整体 的 所 有 数据 不 变 式 。 

如 代码 清单 7-18 所 示 ， 数 据 不 变 式 可 以 由 Contract 静 态 类 的 另外 一 个 方法 进行 定义 。 


代码 清单 7-18 有 专用 的 方法 可 以 用 来 保护 数据 不 变 式 


public class ShippingStrategy 
{ 


























public ShippingStrategy(decimal flatRate) 


{ 
this.flatRate = flatRate; 
} 


[ContractInvariantMethod] 
private void ClassInvariant() 
{ 


Contract.Invariant(this.flatRate > Om, "Flat rate must be positive and non-zero"); 


} 


protected decimal flatRate; 
} 


Contract 类 的 Invariant 方 法 和 Requi res 以 及 Ensures 方 法 的 使 用 模式 一 致 ， 都 是 接受 一 
个 为 满足 契约 而 必须 为 真 的 布尔 谓词 。 上 面 的 示例 中 ，Invariant 方 法 还 有 第 二 个 字符 串 人 参数 
用 来 描述 数据 不 变 式 未 被 保护 而 导致 契约 失败 的 错误 信息 。 我 们 鼓励 尽 可 能 多 地 使 用 
Invariant 方 法 来 保护 每 个 数据 不 变 式 ， 最 好 把 不 同 目的 的 数据 不 变 式 分 隔 开 ， 也 就 是 说 ， 不 
要 用 逻辑 AND 运 算 符 && 把 它们 串 在 一 起 .这样 做 的 好 处 就 是 你 在 失败 时 能 够 准确 地 知道 是 哪个 数 
据 不 变 式 被 破坏 了 。 

如 果 ClassInvariant 方 法 只 是 一 个 普通 的 私有 方法 ， 你 就 需要 亲 目 在 每 个 方法 出 人口 调用 
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该 方法 以 确保 正确 保护 了 所 有 的 数据 不 变 式 。 幸 和 运 的 是 , 代码 契约 给 你 提供 了 更 好 的 方式 : 只 需 
要 使 用 ContractInvariantMethodAttribute 来 标记 方法 即 可 。 注意, 属性 并 不 需要 Attribute 
后 组， 因此 这 里 把 属性 名 简化 为 ContractInvariantMethod。 代 码 契 约会 要 求 类 中 的 其 他 方法 
的 出 人口 处 必须 调用 带 有 这 个 标记 的 方法 以 确保 该 类 的 所 有 数据 不 变 式 没有 被 破坏 。 

可 以 应 用 ContractInvariantMethod 标 记 的 方法 必须 满足 既 没有 返回 值 也 没有 参数 的 前 提 
条 件 ， 当 然 ， 你 仍然 可 以 决定 方法 的 名 称 和 访问 级 别 ， 也 就 是 说 ,可 以 根据 需要 为 它 起 名 ， 也 可 
以 把 它 的 访问 级 别 设置 为 公共 的 或 者 私有 的 。 一 个 类 可 以 有 多 个 ContractInvariantMethod 标 
记 的 方法 ， 因 此 可 以 在 逻辑 上 将 不 同 目的 的 数据 不 变 式 组 织 在 独立 的 方法 中 。 最 后 要 强调 的 是 ， 
这 些 市 有 ContractInvariantMethod 标 记 的 方法 内 必须 只 包含 对 Contract.Invariant 方 法 的 
调用 。 

4. 接口 契约 

这 里 要 讲述 的 最 后 一 个 代码 契约 的 特性 就 是 接口 契约 。 到 目前 为 止 , 你 都 是 在 类 的 实现 上 应 
用 Contract 静 态 类 的 Requires、Ensures 和 Invariant 方 法 。 前 面 也 有 提 到 ，Contract 类 的 静 
态 本 质 使 得 对 其 方法 的 调用 遍布 代码 的 各 个 角落 , 从 而 导致 后 期 移 除 或 者 用 其 他 库 替 换 它 们 时 会 
变 得 非常 困难 。 这 在 一 定 程 度 上 破坏 了 自 适 应 代码 的 理想 状态 , 但 是 在 基础 结构 上 由 于 实际 原因 
而 作 的 妥协 是 可 以 理解 的 。 

最 急迫 的 是 由 于 在 类 实现 上 不 加 限制 地 应 用 代码 契约 而 导致 代码 可 读 性 急剧 下 降 的 问题 。 实 
际 上 ， 这 并 不 真 的 只 是 .NET 代 码 契 约 特性 实现 的 错 ， 持 续 应 用 任何 契约 实现 都 会 造成 同样 的 问 
题 。 无 论 用 什么 方式 在 代码 中 实现 前 置 条 件 、 后 置 条 件 和 数据 不 变 式 ， 有 效 代 码 率 都 会 降低 。 

接口 契约 能 够 解决 这 些 问 题 并 提供 另外 一 个 很 有 用 的 特性 。 代 码 清单 7-19 展 示 了 
ShoppingStrategy 类 的 接口 契约 示例 。 


代码 清单 7-19 ”使 用 专用 类 为 接口 的 所 有 实现 定义 前 置 条 件 、 后 置 条 件 和 数据 不 变 式 


[ContractClass(typeof(ShippingStrategyContract))] 
interface IShippingStrategy 









































{ 
decimal CalculateShippingCost( 
float packageWeightInKilograms, 
Size<float> packageDimensionsInInches, 
RegionInfo destination); 
JD 
人 


[ContractClassFor(typeof(IShippingStrategy))] 
public abstract class ShippingStrategyContract : IShippingStrategy 
{ 
public decimal CalculateShippingCost(float packageWeightInKilograms, Size<float> 
packageDimensionsInInches, RegionInfo destination) 
{ 
Contract.Requires<ArgumentOutOfRangeException>(packageWeightInKilograms > Of, 
"Package weight must be positive and non-zero"); 
Contract.Requires<ArgumentOutOfRangeException>(packageDimensionsInInches.X > Of && 
packageDimensionsInInches.Y > 0f, "Package dimensions must be positive and non-zero"); 


Contract.Ensures(Contract.Result<decimal>() > 0m); 


return decimal.One; 


} 


[ContractInvariantMethod] 
private void ClassInvariant() 
{ 
Contract.Invariant(flatRate > Om, "Flat rate must be positive and non-zero"); 
} 
} 


当然 ， 接 口 契 约 要 先 有 应 用 契约 的 目标 接口 。 上 面 示例 中 ，CalculateShippingCost 方 法 
已 经 被 提取 到 自己 所 属 的 IShippingStrategy 接 口中 了 。 该 示例 是 对 该 接口 应 用 契约 ， 不 再 只 
是 针对 单个 类 实现 应 用 契约 。 这 一 点 很 重要 , 它 让 这 个 示例 与 前 面 所 有 示例 有 了 质 的 区 别 ， 因 为 
它 对 所 有 该 接口 的 实现 类 都 有 效 。 这 就 是 你 能 通过 一 些 实现 和 指令 增强 接口 的 方式 , 而 增强 后 的 
接口 能 拥有 更 强大 的 需求 和 保障 。 

在 编写 接口 契约 代码 时 , 你 还 需要 一 个 专门 的 类 来 实现 接口 的 方法 , 其 中 的 方法 体 只 包含 对 
Contract 静 态 类 的 Requires、Ensures 的 调用 。 抽 象 SshippingStrategyContract 类 提供 的 功 
能 实现 看 起 来 与 前 面 示例 中 的 具体 类 相似 , 只 是 方法 中 缺少 了 实际 的 功能 实现 代码 。 即 使 在 产品 
代码 中 ， 契 约 类 中 包含 的 代码 也 是 这 样 的 。 与 真正 的 实现 类 一 样 ， 也 有 一 个 们 有 Contract- 
InvariantMethod 标 记 的 方法 ， 其 中 只 包含 所 有 对 Contract 带 态 类 的 Invariant 方 法 的 调用 。 

不 笠 的 是 , 为 了 关联 接口 和 契约 类 的 实现 ,你 需要 通过 一 个 属性 完成 一 次 双向 引用 。 这 种 方 
式 不 够 好 ， 因 为 它 会 对 接口 的 简洁 性 造成 影响 ， 如 果 能 避免 会 更 好 。 尽 管 如 此 ， 使 用 
ContractClass 和 ContractClassFor 属 性 分 别 对 接口 和 契约 类 进行 标记 后 ， 你 只 需要 实现 一 次 
前 置 条 件 、 后 置 条 件 和 数据 不 变 式 的 防卫 代码 ， 而 它们 对 该 接口 上 的 所 有 实现 类 都 是 效 的 。 
ContractClass 和 ContractClassFor 属 性 都 可 以 接受 模板 类 ， 前 者 用 于 标记 接口 并 需要 传人 契 
约 类 ， 而 后 者 用 于 标记 契约 类 并 需要 传人 接口 类 。 

到 此 ， 我 们 要 结束 对 代码 契约 的 介绍 了 ， 让 我 们 重新 回 到 Liskov 和 替换 原则 中 与 契约 相关 的 主 
题 讨 论 上 。 最 后 需要 特别 强调 的 一 点 是 : 无 论 是 手动 编码 还 是 使 用 代码 契约 实现 ,如果 契 约 中 有 
任何 前 置 条 件 、 后 置 条 件 或 者 数据 不 变 式 的 断言 失败 了 , 客户 端 都 不 应 该 再 捕获 到 代码 异 名 。 对 
于 客户 端 而 言 , 捕获 异常 这 个 行为 本 身 代 表 了 它 还 能 从 捕获 的 异常 状态 中 恢复 , 但 是 契约 被 破坏 
后 通常 都 不 会 也 不 太 可 能 被 恢复 。 最 理想 的 情况 就 是 通过 功能 测试 发 现 了 所 有 违背 契约 的 问题 ， 
并 在 交付 产品 之 前 修复 所 有 这 些 发 现 的 问题 。 因 此 ， 对 契约 做 单元 测试 就 变 得 非常 重要 了 。 如 果 
在 交付 产品 代码 后 发 现 有 个 破坏 契约 的 问题 依然 存在 且 很 不 幸 地 被 用 户 发 现时 , 最 好 的 处 理 方式 
很 可 能 就 是 强制 关闭 应 用 程序 。 这 时 让 应 用 程序 以 失败 的 方式 退出 是 恰当 的 ,因为 此 时 应 用 程序 
的 内 部 状态 很 可 能 是 无 效 且 无 法 恢复 的 。 对 于 网 页 应 用 ,这 意味 着 显示 一 个 全 局 的 错误 页 面 。 对 
于 昌 面 应 用 ,可 以 给 用 户 一 个 友善 的 提示 并 能 让 他 们 有 机 会 报告 出 现 的 问题 。 所 有 情况 下 ， 都 应 
该 使 用 日 志 记 录 发 生 的 异常 、 当 时 完整 的 堆栈 跟踪 信息 以 及 其 他 尽 可 能 多 的 上 下 文 信息 。 

下 一 节 会 集中 讲解 Liskov 蔡 换 原 则 剩余 的 规则 ， 它 们 主要 应 用 在 协 变 和 逆 变 上 。 
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7.3 协 变 和 逆 变 


Liskov 蔚 换 原 则 的 剩余 规则 都 与 协 变 和 逆 变 相关 。 通 党 来 说 ， 变 体 (variance ) 这 个 术语 主要 
应 用 于 复杂 类 层次 结构 中 以 定义 子 类 型 的 期 望 行 为 。 





7.3:1 定义 


与 前 面 几 节 类 似 ， 在 详细 讲解 Liskov 蔡 换 原 则 在 变 体 上 的 需求 前 ， 会 首先 讲解 变 体 相 关 的 基 
本 概念 。 

1. 协 变 

图 7-4 展 示 了 一 个 非常 小 的 类 层次 结构 ， 它 只 包含 了 两 个 根据 分 类 命名 的 类 型 : Supertype 
和 Subtype。Supertype 定 义 了 被 Subtype 继 承 的 字段 和 方法 。Subtype 通 过 定义 自己 的 字段 和 
方法 来 增强 Supertype。 








Supertype 
-field1 
-field2 


+Method1() 
+Method2() 


Subtype 


-field1 
-field2 
-field3 
+Method10 
+Method20 
+Method3() 








图 7-4 ”在 这 个 类 层次 结构 中 ，Supertype 和 Subtype 是 父子 关系 


多 态 (polymorphism ) 是 一 种 子 类 型 被 看 作 超 类 型 实例 的 能 力 。 我 们 要 感谢 多 态 这 个 面 加 对 
象 编 程 的 强大 特性 〈C# 也 文 持 )。 任 何 能 够 接受 Supertype 类 型 实例 的 方法 也 可 以 直接 接受 
Subtype 类 型 实例 ， 客 户 端 或 服务 代码 都 不 需要 做 类 型 转换 ， 服 务 也 不 需要 知道 任何 子 类 型 相关 
的 信息 。 服 务 代 码 根本 就 不 关心 具体 是 哪个 子 类 型 ,它们 只 知道 自己 处 理 的 是 个 Supertype 类 型 
的 实例 。 

此 时 , 再 引入 男 外 一 个 通过 泛 型 参数 使 用 Supertype 和 /或 Subtype 的 类 型 时 , 我 们 就 需要 讨 
论 变 体 相关 的 主题 了 。 

图 7-$ 是 协 变 〈 covariance ) 概念 的 一 个 形象 的 解释 。 
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ICovariant<Supertype> 





+9upertype MethodWhichReturnsT() 


ICovariant<out T> 


+T MethodWhichReturnsT() 


ICovariant<Subtype> 







+Subtype MethodWhichReturnsT() 
图 7-5 ”由 于 泛 型 参数 的 协 变 ， 基 类 / 子 类 关系 被 保留 下 来 


很 有 意思 的 是 , 这 和 前 面 一 样 也 用 到 了 多 态 这 个 强大 的 特性 。 因 为 有 了 协 变 ， 当 有 方法 需要 
ICovariant<Supertype> 的 实例 时 ， 你 完全 可 以 放心 地 使 用 ICovariant<Subtype> 的 实例 替代 
它 。 能 取得 这 样 的 效果 要 归功 于 协 变 和 多 态 的 紧密 配合 。 

到 目前 为 止 , 我 采用 的 都 是 通用 的 示例 。 为 了 巩固 对 协 变 概 念 的 解释 ,我 将 会 用 一 个 更 真实 
的 场景 来 替代 前 面 的 类 图 以 及 其 中 示意 性 的 名 称 。 代 码 清 单 7-20 展 示 了 通用 的 Entity 基 类 和 具体 
的 User 子 类 间 的 类 层次 结构 。 所 有 Entity 类 型 都 有 一 个 GUID 标 识 符 和 一 个 字符 串 名 称 ， 而 每 个 
User 类 都 有 一 个 Emai1Address 属 性 和 一 个 Date0fBirth 属 性 。 


代码 清单 7-20 “在 这 个 小 域 中 ，User 就 是 一 个 特殊 的 Entity 类 型 


public class Entity 

















{ 
public Guid ID { get; private set; } 
public string Name { get; private set; } 
} 
OA 
public class User : Entity 
{ 
public string EmailAddress { get; private set; } 
public DateTime DateOfBirth { get; private set; } 
} 


这 个 示例 与 Supertype/Subtype 示 例 很 类 似 ， 但 是 目的 性 更 强 。 在 这 个 小 小 的 问题 域 中 需 
要 应 用 存储 库 模 式 。 存 储 库 模式 会 提供 一 个 获取 对 象 的 接口 ， 这 些 对 象 看 起 来 是 在 内 存 中 , 但 是 
实际 上 很 有 可 能 是 从 某 个 完全 不 同 的 存储 介质 中 加 载 进来 的 。 代 码 清 单 7-21 展 示 了 Entity- 
Repository 类 和 它 的 UserRepository 子 类 。 


代码 清单 7-21 不 使 用 泛 型 ，C# 中 的 所 有 继承 都 是 非 变 体 


public class EntityRepository 
{ 
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public virtual Entity GetByID(Guid id) 


{ 
return new Entity() ; 
} 
} 
0 
public class UserRepository : EntityRepository 
{ 
public override User GetByID(Guid id) 
{ 
return new UserQO; 
} 
} 


这 个 示例 与 前 面 的 有 所 不 同 ， 其 中 关键 的 一 点 是 : 不 使 用 泛 型 类 型 ，C# 方 法 的 返回 类 就 不 
是 协 变 的 。 实 际 上 ， 在 子 类 中 尝试 将 GetByID 方 法 的 返回 类 型 更 改 为 User 类 会 直接 引起 一 个 编 
详 错误 。 





error CS0508: 'SubtypeCovariance.UserRepository.GetByID(System.Guid)': return type must be 
"SubtypeCovariance.Entity” to match overridden member 
'SubtypeCovariance.EntityRepository.GetByID(System.Guid)' 


也 许 你 只 是 靠 经 验 判 断 这 样 的 更 改 是 无 法 工作 的 ,但 是 真正 出 错 的 原因 则 是 因为 这 种 情况 下 
的 继承 是 不 具备 协 变 能 力 的 。 如 果 C# 在 继承 时 支持 普通 类 上 的 协 变 ， 你 就 能 够 在 UserRepo- 
sitory 类 中 直接 更 改 方法 的 返回 类 型 。 可 惜 C# 并 没有 这 种 能 力 ， 所 以 你 只 有 两 个 可 用 的 选项 。 

第 一 ， 你 可 以 把 UserRepository 类 的 GetByID 方 法 的 返回 类 型 修改 回 Entity 类 型 ， 然 后 在 
该 方法 返回 的 地 方 应 用 多 态 将 Entity 类 型 的 实例 转换 为 User 类 型 的 实例 。 这 个 方式 不 够 好 ， 
为 这 要 求 UserRepository 的 客户 端 必 须 上 自己 做 实例 类 型 转换 ， 或 者 必须 针对 User 类 型 做 探测 ， 
如 果 返 回 的 是 User 类 型 ， 就 执行 某 些 针对 性 的 代码 。 

第 二 ,你 还 可 以 把 EntityRepository 重 新 定义 为 一 个 需要 泛 型 的 类 型 ， 可 以 把 Entity 类 型 
作为 泛 型 参数 传人 。 这 个 泛 型 参数 是 可 以 协 变 的 ，UserRepository 子 类 可 以 为 User 类 型 指定 超 
类 型 。 代 码 清 单 7-22 举 例 说 明了 第 二 种 方式 。 


代码 清单 7-22 沁 型 化 的 基 类 可 以 利用 协 变 能 力 ， 从 而 允许 子 类 重 写 返回 类 型 


public interface IEntityRepository<TEntity> 
where TEntity : Entity 














{ 

TEntity GetByID(Guid 1d); 
} 
7 
public class UserRepository : IEntityRepository<User> 
{ 

public User GetByID(Guid id) 

{ 

return new User(C) ; 


} 


7.3 协 变 和 逆 变 211 





示例 代码 中 并 没有 继续 使 用 可 以 实例 化 的 具体 EntityRepository， 而 是 引入 了 一 个 没有 
GetByID 方 法 默认 实现 的 接口 。 这 里 使 用 接口 虽然 不 是 必须 的 ， 但 仍然 是 很 合理 的 ， 因 为 我 们 前 
面 一 直 在 强调 ， 让 客户 端 代 码 依赖 接口 要 比 依赖 实现 好 很 多 。 

你 也 会 注意 到 ， 接 口 泛 型 参数 后 面 还 有 一 个 where 子 句 。 应 用 where 子 句 的 接口 比 原 有 实 
现 有 了 更 高 的 灵活 度 , 因为 where 子 句 可 以 保证 接口 的 子 类 总 是 传人 Entity 类 型 层次 结构 中 的 
类 型 。 

新 的 UserRepository 类 的 客户 端 无 需 青 做 癌 下 的 类 型 转换 ， 因 为 它们 直接 得 到 的 就 是 User 
类 型 对 象 ， 而 不 是 Entity 类 型 对 象 ， 同 时 ，EntityRepository 和 UserRepository 两 个 类 之 间 
的 父子 继承 关系 也 得 以 保留 。 

2. 逆 变 

逆 变 是 一 个 类 似 于 协 变 的 概念 。 协 变 只 是 与 方法 返回 类 型 的 处 理 相 关 ， 而 送 变 
( contravariance ) 是 与 方法 参数 类 型 的 处 理 相 关 。 

图 7-6 使 用 前 面 讨论 过 的 Supertype 和 Subtype 示 例 , 展示 了 通过 泛 型 参数 首 变 的 类 型 之 间 的 
关系 。 











IContravariant<Subtype> 


+Vvoid MethodWhichAcceptsT(Subtype parameter) 


IContravariant<in T> 


+void MethodWhichAcceptsT(T parameter) 


IContravariant<Supertype> 


+Void MethodWhichAcceptsT(Supertype parameter) 
图 7-6 ”由 于 泛 型 参数 的 逆 变 ， 基 类 / 子 类 关系 被 倒置 了 


IContravariant 接 口 定义 的 方法 只 接受 由 泛 型 参数 指定 类 型 的 单个 参数 。 这 里 的 泛 型 参数 
巾 关键 字 in 标 记 ， 表 示 它 是 可 逆 变 的 。 

后 续 的 类 层次 结构 可 以 以 此 类 推 ， 这 表明 了 继承 层次 结构 已 经 被 古 倒 了 : IContravariant 
<Subtype> 成 为 了 超 类 ，IContravariant<Supertype> 则 变 成 了 子 类 ， 尽 管 从 直觉 上 看 来 有 些 
别扭 和 奇怪 ,但 后 面 你 很 快 会 知道 为 什么 逆 变 会 有 这 种 行为 以 及 为 什么 它 很 有 用 。 

代码 清单 7-23 展 示 了 .NET Framework 提 供 的 IEqualityCompare 接 口 的 一 个 具体 的 实现 。 
EntityEqualityComparer 类 的 Equal1s 方 法 接受 前 面 定 义 的 Entity 类 型 参数 。 比 较 过 程 的 实现 
并 不 重要 ， 只 是 简单 地 比较 了 两 个 实体 的 号 份 标识 。 


代码 清单 7-23 IEqualityComparer 接 口 允许 定义 诸如 EntityEqualityComparer 类 这 样 的 功 
能 对 象 


public interface IEqualityComparer<in TEntity> 
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where TEntity : Entity 


bool EqualsCTEntity left, TEntity right); 
} 
VN 
public class EntityEqualityComparer : IEqualityComparer<Entity> 
{ 

public bool Equals(Entity left, Entity right) 

{ 

return left.ID == right.ID; 

} 

} 


代码 清单 7-24 展 示 了 逆 变 在 EntityEqualityComparer 类 上 的 作用 。 
代码 清单 7-24” 逆 变 颠倒 了 类 层次 结构 ， 它 允许 在 需要 具体 比较 器 的 地 方 传 人 更 通用 的 比较 器 


[Testj 
public void UserCanBeComparedWithEntityComparer() 
{ 





SubtypeCovariance.IEqualityComparer<User> entityComparer = new 
EntityEqualityComparer(); 
var userl = new UserQO); 
var User2 = new User() ; 
entityComparer.Equals(userl1l, user2) 
.Should() .BeFalse() ; 
} 





如 果 没 有 逆 变 ( 接口 定义 中 泛 型 参数 前 不 起 上 腿 的 in 关键 字 )， 编 译 时 会 直接 报错 。 


error CS0266: Cannot implicitly convert type 'SubtypeCovariance.EntityEqualityComparer' to 
'SubtypeCovariance.IEqualityComparer<SubtypeCovariance.User>'. An explicit conversion exists 
(are you missing a cast?) 


错误 信息 告诉 你 ， 这 里 并 没有 从 EntityEqual1ityComparer 到 IEqua1ityComparer<User> 
的 类 型 转换 器 ， 直 党 上 就 是 这 样 的 ， 因 为 Entity 是 超 类 型 ， 而 User 是 子 类 型 。 然 而 ， 因 为 
IEqualityComparer 文 持 逆 变 ， 所 以 现 有 的 继承 层次 结构 被 颠倒 上， 此 时 你 就 能 够 做 到 通过 使 
用 IEqualityComparer 接 口 癌 需要 具体 类 型 参数 的 地 方 传人 更 通用 的 类 型 。 

3. 不 变性 

除了 协 变 和 逆 变 的 行为 外 , 类 型 本 身 具 有 不 变性 。 这 里 的 不 变性 与 本 章 前 面 讲 述 的 代码 契约 
中 的 数据 不 变性 〈data invariant ) 是 不 同 的 。 这 里 的 不 变性 是 指 “ 不 会 生成 变 体 ”。 如 果 一 个 类 型 
完全 不 能 生成 变 体 ， 那么 就 无 法 在 该 类 型 上 形成 类 型 层次 结果 。 代 码 清单 7-25 使 用 IDictionary 
泛 型 类 型 来 说 明 这 个 事实 。 
代码 清单 7-25 有 些 泛 型 类 型 既 不 可 协 变 也 不 可 逆 变 ， 因 此 它们 具有 不 变性 


[TestFixturel] 
public class DictionaryTests 


{ 

















[Test] 
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public void DictionaryIsInvariant() 
{ 
// Attempt covariance... 
IDictionary<Supertype, Supertype> supertypeDictionary = new Dictionary<Subtype, 
Subtype> QO; 


// Attempt contravariance... 
IDictionary<Subtype, Subtype> subtypeDictionary = new Dictionary<Supertype, 
Supertype>() ; 
} 


} 


DictionaryIsInvariant 测 试 方法 第 一 行 试图 在 给 一 个 键 和 值 类 型 都 是 Supertype 的 字典 
赋值 ， 但 所 赋 字 典 对 象 的 键 和 值 类 型 却 都 是 Subtype 类 型 的 。 因 为 IDictionary 类 型 是 不 可 协 变 
的 ， 因 此 这 一 名 代码 不 会 成 功 。 

第 二 行 代码 也 是 无 效 的 ， 因 为 它 在 尝试 做 倒置 : 给 一 个 键 和 值 类 型 都 是 Subtype 的 字典 赋值 
一 个 键 和 值 类 型 都 是 Supertype 类 型 的 字典 。 失 败 的 原因 是 因为 IDictionary 类 型 也 是 不 可 逆 变 
的 ， 因 此 无 法 倒置 Subtype 和 Supertype 类 型 间 的 继承 层次 结构 。 

从 IDictionary 类 型 既 不 可 协 变 也 不 可 逆 变 的 事实 即 可 知道 它 必定 是 个 非 变 体 , 的确 是 这 样 
的 ， 代 码 清单 7-26 展 示 了 IDictionary 接 口 的 声明 方式 ,你 可 以 看 到 ， 定 义 中 并 没有 对 in 和 out 
关键 字 的 引用 ， 而 这 二 者 则 分 别 是 用 来 指定 协 变 和 逆 变 特性 的 。 


代码 清单 7-26 IDictionary 接 口 的 所 有 泛 型 参数 都 没有 in 或 out 关 键 字 标 记 


public interface IDictionary<TKey，TValue> : ICollection<KeyValuePair<TKey, TValue>>, 
IEnumerable<KeyValuePair<TKey, TValue>>, IEnumerable 























与 前 面 证明 的 一 般 情 况 ( 也 就 是 说 , 没有 泛 型 类 型 ) 一 样 ，C#i 滞 言 的 方法 参数 类 型 和 返回 类 
型 都 是 不 可 变 的 。 只 有 在 涉及 泛 型 时 才能 将 类 型 定义 为 可 协 变 的 或 可 逆 变 的 。 


7.3.2 Liskov 类 型 系统 规则 


现在 你 已 经 了 解 了 变 体 的 基础 ， 本 节 会 回 到 Liskov 替 换 原 则 相关 的 主题 上 。Liskov 替 换 原 则 
定义 了 以 下 三 个 规则 ， 其 中 前 两 个 都 是 与 变 体 相关 的 。 

口 子 类 型 的 方法 参数 必须 是 可 逆 变 的 。 

口 子 类 型 的 返回 类 型 必须 是 可 协 变 的 。 

口 不 允许 引发 新 异常。 

只 有 方法 参数 支持 逆 变 而 且 返 回 类 型 支持 协 变 , 你 才 可 以 编写 出 严格 遵守 Liskov 蕉 换 原 则 的 
代码 。 

第 三 条 规则 与 可 变性 无 关 ， 因 此 在 下 面 单独 讨论 一 下 。 

不 允许 引发 新 异常 

这 条 规则 比 其 他 两 条 Liskov 蔡 换 原则 规则 要 直观 的 多 ， 它 主要 是 与 编程 语言 的 类 型 系统 相 
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关 。 你 首先 要 思考 的 是 : 什么 才 是 异常 的 真正 目的 ? 

异 销 机 制 的 主旨 就 是 将 错误 的 汇报 和 处 理 环节 分 隔 开 。 通 党 情况 下 , 汇报 器 和 处 理 需 就 是 目 
的 和 应 用 场景 截然 不 同 的 两 种 类 型 。 异 常 对 象 表 示 通 过 该 异常 类 型 发 生 的 错误 以 及 相应 的 数据 。 
任何 代码 都 可 以 捕获 和 啊 应 异常 ,同样 ,任何 代码 也 都 可 以 构造 和 3 引发 异常 。 尺 管 如 此 ， 最 好 还 
是 在 代码 确定 能 做 一 些 有 意义 的 处 理 时 才 去 捕获 异常 。 比 如 ,简单 的 数据 库 事务 的 回 深 处 理 , 或 
是 复杂 的 能 让 用 户 看 到 并 反馈 详细 错误 信息 给 开发 人 员 的 绚丽 界面 的 处 理 。 

同样 ,捕获 异常 后 不 做 任何 处 理 或 只 捕获 最 通用 的 Exception 基 类 都 是 不 可 取 的 。 二 者 结合 
的 情况 就 更 糟糕 了 。 对 于 只 捕获 最 通用 的 Exception 基 类 这 种 情况 ,你 实际 上 是 在 尝试 捕获 和 响 
应 任何 异常 ， 包 括 那 些 你 实际 上 根本 无 法 处 理 和 恢复 的 情况 ， 比 如 OutOfMemoryException、 
StackOverf1owException 或 ThreadAbortException 等 。 如 果 要 想 改 善 这 种 状况 ， 你 需要 确保 
总 是 从 App1licationException 类 派生 自己 的 异常 ， 因 为 很 多 无 法 恢复 的 异常 都 是 从 System- 
Exception 类 派生 出 来 的 。 然 而, 这 要 取决 于 你 所 依赖 的 第 三 方 库 是 否 也 采用 了 这 种 好 的 实践 方式 。 

代码 清单 7-27 展 示 的 两 个 异 篆 类 型 在 同一 个 类 层次 结构 下 是 兄弟 关系 。 这 种 兄弟 关系 可 以 防 
止 只 针对 单个 异常 的 捕获 代码 块 却 能 截获 两 种 异常 的 情况 。 


代码 清单 7-27 两 个 异常 都 是 Exception 类 , 但 是 二 者 并 非 父子 继承 关系 


public class EntityNotFoundException : Exception 


{ 
































public EntityNotFoundException() 


: base(Q) 
{ 
} 
public EntityNotFoundException(string message) 
: base (message) 
{ 
} 
} 
7 
public class UserNotFoundException : Exception 
{ 
public UserNotFoundException() 
: base(Q) 
{ 
} 
public UserNotFoundException(string message) 
: base (message) 
{ 
} 
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如 果 想 要 在 单个 捕获 代码 块 中 同时 捕获 EntityNotFoundExcetpion 和 UserNotFound- 
Exception 两 个 异常 ， 你 应 该 去 捕获 通用 的 Exception 类 型 ， 但 这 并 不 是 值得 推荐 的 做 法 。 

代码 清单 7-28 展 示 的 EntityRepository 和 UserRepository 类 实现 代码 会 加 重 这 个 问题 。 
代码 清单 7-28 ”同一 接口 的 两 个 不 同 的 实现 很 有 可 能 引发 两 种 不 同类 型 的 异常 


public Entity GetByID(Guid id) 











{ 
Contract.Requires<EntityNotFoundException>(id != Guid.Empty); 
return new Entity() ; 

} 

OA 

public User GetByID(Guid id) 

{ 
Contract.Requires<UserNotFoundException>(id != Guid.Empty); 
return new UserQO; 

} 


这 两 个 类 型 都 使 用 了 代码 契约 来 断言 一 个 前 置 条 件 : 方法 的 输入 参数 id 必须 不 等 于 
Guid.Empty。 二 者 都 会 在 不 满足 赣 约 时 引发 目 有 的 异常 类 型 。 我 们 一 起 来 细 想 一 下 示例 实现 代 
码 对 使 用 存储 库 的 客户 端的 影响 。 客 户 端 代 码 需要 考虑 去 捕获 这 两 种 异 稼 ， 但 是 如 果 不 捕获 
Exception 类 型 ， 就 无 法 在 单个 捕获 代码 块 中 同时 捕获 这 两 种 异常 类 型 。 代 码 清单 7-29 展 示 的 单 
元 测试 是 这 两 个 存储 库 类 型 的 客户 端 。 


代码 清单 7-29 因为 无 法 将 UserNotFoundException 赋 值 给 EntityNotFoundException 异 常 ， 
所 以 单元 测试 会 失败 


[TestFixture(typeof(EntityRepository), typeof (Entity))] 

[TestFixture(typeof(UserRepository), typeof(User))] 

public class ExceptionRuleTests<TRepository, TEntity> 
where TRepository : IEntityRepository<TEntity>, new() 

















{ 
[Test] 
public void GetByIDThrowsEntityNotFoundException() 
{ 
var repo = new TRepository() ; 
Action getByID = () => repo.GetByID(Guid.Empty); 
getByID.ShouldThrow<EntityNotFoundException>(); 
} 
} 


因为 UserRepository 并 不 会 像 要 求 的 那样 引发 EntityNotFoundException 异 常 , 所 以 这 个 
单元 测试 会 失败 。 如 果 UserNotFoundException 是 EntityNotFoundException 的 子 类 ,这 个 测 
试 就 可 以 成 功 而 且 单个 捕获 代码 块 也 能 够 保证 捕获 两 种 类 型 。 
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这 个 问题 会 成 为 客户 端 维护 的 一 个 负担 。 如 有 果 客 户 端 是 在 使 用 接口 并 调用 接口 的 方法 , 那么 
它 就 不 应 该 知道 接口 之 后 的 任何 信息 。 这 就 回 到 了 随从 反 模 式 和 阶梯 模式 之 间 的 争论 。 如 果 引 入 
了 不 属于 期 望 异 禹 的 类 层次 结构 的 新 异常 ,客户 端 就 必须 直接 引用 这 些 新 的 异 稼 。 而 且 更 粳 糕 的 
是 ， 客 户 闻 将 不 得 不 在 任何 新 的 异常 类 型 引入 时 做 出 相应 的 更 改 。 

相反 , 每 个 接口 都 应 该 有 一 个 统一 的 基础 异常 类 型 , 它 可 以 将 必要 的 错误 信息 从 异常 汇报 天 
传 给 异常 处 理 融 。 














7.4 总结 


表面 上 看 ，Liskov 蔡 换 原 则 是 SOLID 原 则 中 最 复杂 的 一 个 。 你 需要 理解 巢 约 和 变 体 的 概念 才 
可 以 应 用 Liskov 蔡 换 原 则 编写 具有 更 高 自 适 应 能 力 的 代码 。 

上 默认 情况 下 , 接口 并 不 会 向 用 户 传达 前 置 条 件 和 后 置 条 件 的 规则 。 通 过 创建 防卫 子 句 可 以 让 
应 用 程序 在 运行 时 进一步 约束 参数 的 有 效 值 范围 。Liskov 蔡 换 原 则 提出 了 一 些 指导 原则 ， 比 如 ， 
子 类 不 能 加 强 前 置 条 件 或 削弱 后 置 条 件 等 。 

相似 地 ，Liskov 蔡 换 原 则 也 对 子 类 型 的 可 变性 提出 了 一 些 规则 。 子 类 型 的 方法 参数 和 返回 类 
型 应 该 分 别 是 可 逆 变 的 和 可 协 变 的 。 此 外 , 任何 可 能 随 着 菏 个 新 的 接口 实现 而 引入 的 新 异常 都 应 
该 派生 一 个 已 有 的 基础 异 稼 类 型 。 如 果 不 这 样 做 , 会 很 可 能 导致 现 有 的 客户 端 错过 捕获 这 个 新 的 
异常 类 型 而 导致 程 序 朋 涡 。 

如 条 没 有 这 等 Liskov 符 换 原 则 的 这 些 规 则 , 客户 痪 要 处 理 好 类 层次 结构 中 所 有 类 之 间 的 关系 
会 变 得 更 难 。 理 想 情 况 下 , 不 论 运行 时 使 用 的 是 哪个 具体 的 子 类 型 ， 客 户 端 都 可 以 只 引用 一 个 基 
类 或 接口 而 且 无 需 担 心 行为 变化 。 这 么 多 问题 混合 在 一 起 会 引起 代码 之 间 的 依赖 , 因此 最 好 是 把 
它们 分 隔 开 。 任 何 对 Liskov 蔡 换 原 则 定义 的 规则 的 违 青 都 应 该 被 看 作 技术 债务 ， 而 且 像 前 面 几 音 
讲 到 的 ， 最 好 能 尽早 地 处 理 掉 这 些 技术 债务， 否则 后 患 无 穷 。 





























接口 分 部 原则 





完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 理解 接口 分 离 原则 的 重要 性 。 

口 主要 按照 客户 端 代码 的 需求 编写 接口 。 

口 创建 更 小 更 清晰 的 接口 。 

口 识别 可 以 应 用 接口 分 离 原 则 的 场景 。 

口 按照 接口 实现 的 依赖 关系 分 割 接口 。 

基于 前 面 儿童 的 讲解 ,我 们 已 经 知道 ， 在 现代 面向 对 象 编程 的 工具 集中 ,接口 是 一 个 非常 关 
键 的 武 右 。 接口 所 表达 的 是 客户 端 代 码 需求 和 需求 具体 实现 之 间 的 边界 。 接 口 分 离 原 则 主张 接口 
应 该 足够 小 。 

接口 的 每 个 成 员 ( 属性 、 事 件 和 方法 ) 都 需要 按照 接口 的 整体 目标 来 实现 。 除 非 接 口 的 所 有 
客户 端 都 需要 所 有 成 员 , 否则 要 求 每 个 实现 都 满足 一 个 大 而 全 的 契约 是 毫 无 意义 的 。 要 牢记 单一 
职责 原则 和 可 以 轻易 使 用 的 修饰 器 模式 ， 对 于 接口 包含 的 每 个 成 员 而 言 ， 若 要 实现 为 修饰 需 ， 必 
须要 有 一 个 对 应 的 有 效 类 比 。 

最 简单 的 接口 只 有 一 个 服务 于 单个 目的 的 方法 。 这 种 粒度 的 接口 看 起 来 很 像 是 委托 , 但 是 它 
们 要 比 委 托 强 大 很 多 。 


8.1 一 个 分 离 接口 的 示例 


本 章 会 完整 讲解 一 个 从 单个 巨型 接口 到 多 个 小 型 接口 分 离 过 程 的 示例 ,分 离 过 程 中 创建 了 各 
种 各 样 的 修饰 希 ， 用 于 详细 讲解 大 量 应 用 接口 分 离 原则 能 带 来 的 主要 好 处 。 












































8.1.1 一 个 简单 的 CRUD 接口 


下 面 这 个 接口 本 映 很 简单 ， 只 有 五 个 方法 。 它 用 于 允许 用 户 对 实体 对 象 的 持久 存储 进行 
CRUD 操 作 。CRUD 代 表 创 建 、 读 取 、 更 新 和 删除 ( create, read, update, and delete )。 这 四 个 动作 
是 客户 端 维护 实体 对 象 持久 存储 的 最 常见 的 一 组 操作 。 图 8-1 展 示 的 UML 类 图 给 出 了 
ICreateReadUpdateDelete 接 口上 的 可 用 操作 。 
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<<|NTERFACE> > 
ICreateReadUpdateDelete 


+Create() 


+ReadOnel() 
+ReadAll() 
+Update() 
+Delete() 








图 8-1 最 初 的 还 未 分 离 的 接口 


读 取 操 作 被 分 割 成 为 两 个 方法 , 一 个 用 于 从 存储 中 获取 单个 记录 , 为 外 一 个 用 于 一 次 获取 所 
有 记录 。 代 码 清单 8-1 展 示 了 该 接口 的 代码 。 


代码 清单 8-1 一 个 用 于 对 实体 对 象 做 CRUD 操 作 的 简单 接口 


public interface ICreateReadUpdateDelete<TEntity> 








: void Create(TEntity entity); 
TEntity ReadOne(Guid identity); 
IEnumerable<TEntity> ReadA11() ; 
void Update(TEntity entity); 
void Delete(TEntity entity); 

} 


ICreateReadUpdateDelete 是 一 个 泛 型 接口 ， 可 以 接受 不 同 的 实体 类 型 。 然 而 ， 这 种 泛 型 
化 接口 而 不 是 泛 型 化 每 个 方法 的 方式 ， 需 要 客户 端 首先 声明 自己 要 依赖 的 TEntity。 如 果 客 户 端 
想 要 对 多 种 类 型 的 实体 做 CRUD 操 作 ， 就 需要 为 每 个 实体 类 型 创建 一 个 ICreateReadUpdate- 
Delete<TEntity> 实 例 。 

















注意 ”尽管 客户 端 需要 为 每 个 实体 类 型 创建 一 个 ICreateReadUpdateDelete<TEntity> 接 
口 实例 ， 但 是 只 需要 ICreateReadUpdateDe1lete<TEntity> 的 一 个 实现 就 能 够 满足 所 有 有 具 
体 的 TEntity 类 型 。 因 为 这 个 实现 也 是 泛 型 化 的 。 


CRUD 中 的 每 个 操作 都 是 由 对 应 的 ICreateReadUPdateDe1ete 接 口 实现 来 执行 ， 也 包括 所 
有 修饰 器 实现 。 如 代码 清单 8-2 中 展示 的 日 志和 事务 处 理 等 修饰 咒 实 现 都 是 可 以 接受 的 。 


代码 清单 8-2 ”有 些 修 饰 带 作 用 于 所 有 方法 


public class CrudLogging<TEntity> : ICreateReadUpdateDelete<TEntity> 
{ 
private readonly ICreateReadUpdateDelete<TEntity> decoratedCrud; 
private readonly ILog 1og; 
public CrudLogging(ICreateReadUpdateDelete<TEntity> decoratedCrud, ILog 1og) 
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{ 
this.decoratedCrud = decoratedCrud; 
this.l1og = 109; 
} 
public void Create(TEntity entity) 
{ 
log.InfoFormat("Creating entity of type {0}", typeof (TEntity).Name); 
decoratedCrud.Create(entity); 
} 


public TEntity ReadOne(Guid identity) 
{ 
1log.InfoFormat("Reading entity of type {0} with identity {1}", 
typeof (TEntity).Name, identity); 
return decoratedCrud.ReadOne(identity); 





} 
public IEnumerable<TEntity> ReadAl1Q 
{ 
1log.InfoFormat("Reading all entities of type {0}", typeof(TEntity).Name); 
return decoratedCrud.ReadAl11QO; 
} 
public void Update(TEntity entity) 
{ 
1log.InfoFormat("Updating entity of type {0}", typeof (TEntity).Name); 
decoratedCrud.Update(entity); 
} 
public void Delete(TEntity entity) 
{ 
log.InfoFormat("Deleting entity of type {0}", typeof(TEntity).Name); 
decoratedCrud.Delete(entity); 
} 
} 
J 
public class CrudTransactional<TEntity> : ICreateReadUpdateDelete<TEntity> 
{ 


private readonly ICreateReadUpdateDelete<TEntity> decoratedCrud; 
public CrudTransactional(ICreateReadUpdateDelete<TEntity> decoratedCrud) 
{ 


this.decoratedCrud = decoratedCrud; 


public void Create(TEntity entity) 
{ 
using (var transaction = new TransactionScope()) 
{ 
decoratedCrud.Create (entity); 


transaction.Complete(); 
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} 
public TEntity ReadOne(Guid identity) 
{ 
TEntity entity; 
using (var transaction = new TransactionScope()) 
{ 
entity = decoratedCrud.ReadOne(identity); 
transaction.Complete() ; 
} 
return entity; 
} 
public IEnumerable<TEntity> ReadAl11() 
{ 
IEnumerable<TEntity> allEntities; 
using (var transaction = new TransactionScope()) 
{ 
allEntities = decoratedCrud.ReadA11Q; 
transaction.Complete(); 
} 
return allEntities; 
} 
public void Update(TEntity entity) 
{ 
using (var transaction = new TransactionScope()) 
{ 
decoratedCrud.Update (entity); 
transaction.Complete(); 
} 
} 
public void Delete(TEntity entity) 
{ 
using (var transaction = new TransactionScope()) 
{ 
decoratedCrud.Delete(entity); 
transaction.Complete(); 
} 
} 





用 于 记录 日 志和 管理 事务 的 修饰 絮 都 属于 横 切 关注 点 (cross-cutting concern )。 几 乎 所 有 的 接 
口 以 及 接口 中 的 方法 都 可 以 应 用 日 志和 事务 管理 这 两 个 修饰 硕 。 因 此 , 为 了 避免 在 多 个 接口 中 重 
复 实 现 ， 你 可 以 使 用 面向 方面 编程 来 修饰 接口 的 所 有 实现 。 
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有 些 修饰 妖 只 应 用 于 接口 的 部 分 ?方法 上 ， 而 不 是 所 有 的 方法 。 比如 ， 0 
储 中 永久 删除 某 个 实体 前 提示 用 户 , 这 也 是 一 个 很 常见 的 需求 。 切记, 请 不 要 去 改变 现 有 的 类 
现 ， 这 会 违背 开放 与 封闭 原则 。 相 反 ， 你 应 该 创建 客户 端 用 来 执 Re 的 一 于， 
代码 清单 8-3 展 示 了 ICreateReadUpdateDe1ete<TEntity> 接 口 的 Delete 方 法 。 


代码 清单 8-3 ”在 只 要 求 修 饰 部 分 接口 时 可 以 使 用 接口 分 离 


public class DeleteConfirmation<TEntity> : ICrud<TEntity> 











{ 
private readonly ICreateReadUpdateDelete<TEntity> decoratedCrud; 
public DeleteConfirmation(ICreateReadUpdateDelete<TEntity> decoratedCrud) 
{ 
this.decoratedCrud = decoratedCrud; 
} 
public void Create(TEntity entity) 
{ 
decoratedCrud.Create(entity); 
} 
public TEntity ReadOne(Guid identity) 
{ 
return decoratedCrud.ReadOne(identity); 
} 
public IEnumerable<TEntity> ReadAl11Q 
{ 
return decoratedCrud.ReadAl11QO; 
} 
public void Update(TEntity entity) 
{ 
decoratedCrud.Update(entity); 
} 
public void Delete(TEntity entity) 
{ 
Console.WriteLine("Are you sure you want to delete the entity? [y/N]'"); 
var keyInfo = Console.Readkey(); 
if (keyInfo.Key == ConsoleKey.Y) 
{ 
decoratedCrud.Delete(entity); 
} 
} 
} 


顾名思义 ,DeleteConfirmation<TEntity> 类 只 修饰 了 Delete 方 法 。 其 余 方 法 都 是 直 托 方 
法 。 直 托 ( pass-through ) 代表 对 该 方法 不 做 任何 实际 的 修饰 : 不 修饰 接口 方法 ， 就 好 像 直接 调用 
被 修饰 的 接口 方法 一 样 。 尽管 实际 上 这 些 直 托 方法 什么 都 没有 做 ,为 了 确保 单元 测试 的 覆盖 率 并 
确认 它们 是 否 正 确 委 托 , 依然 需要 为 这 些 直 托 方法 编写 测试 方法 以 验证 方法 行为 是 否 正 确 。 但 这 
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样 做 与 接口 分 离 的 方式 比较 起 来 要 麻烦 很 多 。 

通过 把 Delete 方 法 从 ICreateReadUpdateDelete<TEntity> 接 口 分 离 后 ， 你 会 得 到 以 下 两 
个 接口 ， 如 代码 清单 8-4 所 示 。 
代码 清单 8-4 ”ICreateReadUpdateDelete 接 口 被 一 分 为 二 


public interface ICreateReadUpdate<TEntity> 


{ 
void Create(TEntity entity); 
TEntity ReadOne(Guid identity); 
IEnumerable<TEntity> ReadA11() ; 
void Update(TEntity entity); 

} 

J 

public interface IDelete<TEntity> 

{ 
void Delete(TEntity entity); 

} 


将 ICreateReadUpdateDe1lete 接 口 一 分 为 二 后 ,就 可 以 只 对 IDelete<TEntity> 接 口 提 供 确 
认 修 饰 絮 的 实现 ， 如 代码 清单 8-5 所 示 。 


代码 清单 8-5 ”只 在 相关 的 接口 上 应 用 确认 修饰 带 


public class DeleteConfirmation<TEntity> : IDelete<TEntity> 


{ 
private readonly IDelete<TEntity> decoratedDelete; 
public DeleteConfirmation(IDelete<TEntity> decoratedDelete) 
{ 
this.decoratedDelete = decoratedDelete; 
} 
public void Delete(TEntity entity) 
{ 
Console.WriteLine("Are you sure you want to delete the entity? [y/N]"); 
var keyInfo = Console.ReadKey() ; 
if (keyInfo.Key == ConsoleKey.Y) 
{ 
decoratedDelete.Delete(entity); 
} 
} 
} 


上 面 示 例 中 有 了 一 些 改进 ,代码 量 更 少 了 , 代码 意图 也 变 得 更 清晰 了 , 不 再 需要 那么 多 直 托 
方法 。 同 样 ， 代 码 量 变 少 也 意味 着 相应 的 测试 工作 量 也 变 少 了 。 
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在 讨论 下 一 个 修饰 希 前 ， 先 考虑 是 否 能 重 构 现 有 的 DeleteConfirmation 修 人 饰 锅 。 你 应 该 把 
要 求 用 户 答复 的 动作 封装 在 一 个 简单 的 接口 中 , 这 样 就 可 以 为 多 种 用 户 交 互 类 型 ( 比如 , 控制 台 、 
Windows Forms 和 Windows Presentation Foundation 等 ) 编写 对 应 的 接口 实现 ， 同 时 也 不 会 影响 该 
接口 的 修饰 器 。 因 为 DeleteConfirmation 类 现在 并 不 符合 单一 职 贡 原则， 所 以 需要 重 构 它 。 重 
构 原 有 DeleteConfirmation 类 的 具体 理由 有 两 个 : 该 类 委托 的 接口 已 经 发 生 了 改变 ,以 及 会 有 
不 同 的 获得 用 户 答复 的 交互 方式 。 要 求 用 户 确认 是 否 真 的 想 要 删除 某 个 实体 只 需要 一 个 非常 简单 
的 类 似 于 谓词 的 接口 ， 正 如 代码 清单 8-6 所 示 。 


代码 清单 8-6 ”一 个 很 简单 的 接口 ， 用 于 征求 用 户 对 某 些 事情 的 确认 


public interface IUserInteraction 














{ 
bool Confirm(string message); 
} 
8.1.2 ”缓存 


下 一 个 需要 你 实现 的 修饰 器 是 针对 Read0ne 和 ReadA11 这 两 个 读 取 方法 的 。 你 想 在 这 两 个 读 
取 方 法 中 缓存 读 取 的 数据 并 用 作 后 续 请 求 的 返回 。 而 对 于 Create 和 Update 方 法 而 言 ， 绥 存 都 是 
没有 意义 的 ， 代 人 码 清单 8-7 中 的 第 一 个 修饰 絮 包 含 了 并 不 需要 的 直 托 方法 。 


代码 清单 8-7 ”缓存 修饰 硕 包 含 了 元 余 的 直 托 方 法 


public class CrudCaching<TEntity> : ICreateReadUpdate<TEntity> 
{ 








private TEntity cachedEntity; 
private IEnumerable<TEntity> allCachedEntities; 
private readonly ICreateReadUpdate<TEntity> decorated; 


public CrudCaching(ICreateReadUpdate<TEntity> decorated) 


{ 
this.decorated = decorated; 
} 
public void Create(TEntity entity) 
{ 
decorated.Create(entity); 
} 


public TEntity ReadOne(Guid identity) 


{ 
if(cachedEntity == null) 
{ 
cachedEntity = decorated.ReadOne(identity); 
} 


return cachedEntity; 
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public IEnumerable<TEntity> ReadAl11() 


: if (allCachedEntities == null) 
: allCachedEntities = decorated.ReadA11Q); 
i allCachedEntities; 

} 

public void Update(TEntity entity) 

. decorated.Update(entity); 

} 





通过 再 次 应 用 接口 分 离 原则 ， 你 可 以 把 两 个 用 于 读 取 数据 的 方法 组 织 到 它们 自己 的 接口 中 ， 
然后 就 可 以 单独 修饰 这 个 只 用 于 读 取 数据 的 接口 。 代 码 清 单 8-8 展 示 了 新 的 IRead 接 口 ,， 以 及 相应 
的 绥 存 修饰 需 。 
代码 清单 8-8 ReadCaching 类 只 用 于 修饰 ITRead 接 口 


public interface IRead<TEntity> 


TEntity ReadOne(Guid identity) ; 
IEnumerab le<TEntity> ReadA11() ; 
} 
2 
public class ReadCaching<TEntity> : IRead<TEntity> 
{ 


private TEntity cachedEntity; 
private IEnumerable<TEntity> al1CachedEntities ; 


private readonly IRead<TEntity> decorated; 
public ReadCaching(CIRead<TEntity> decorated) 


{ 
this.decorated = decorated; 
} 
public TEntity ReadOne(Guid identity) 
{ 
if(cachedEntity == null) 
{ 
cachedEntity = decorated.ReadOne(identity); 
} 
return CachedEntity ; 
} 


public IEnumerable<TEntity> ReadAl11() 
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{ 
if (allCachedEntities == null) 
{ 
allCachedEntities = decorated.ReadA11() ; 
} 
return allCachedEntities; 
} 


} 
在 你 实现 最 后 一 个 修饰 器 类 前 ， 原 始 的 接口 只 剩 下 了 两 个 方法 ， 如 代码 清单 8-9 所 示 。 
代码 清单 8-9 剩余 的 两 个 方法 也 可 以 统一 为 单个 方法 


public interface ICreateUpdate<TEntity> 
{ 





void Create(TEntity entity); 


void Update(TEntity entity); 
} 


除了 方法 名 ，Create 和 Update 方 法 的 签名 完全 相同 。 除 此 之 外 , 它们 的 目的 也 很 相似 : 前 者 
用 于 保存 一 个 新 建 的 实体 , 后 者 用 于 保存 一 个 已 有 的 实体 。 你 可 以 把 这 二 者 统一 为 单个 Save 方 法 ， 
该 方法 内 部 清楚 如 何 处 理 新 实体 和 已 有 实体 ， 而 客户 问 代 码 不 需要 知道 这 些 细节 。 毕 范 ， 客 户 端 
很 有 可 能 需要 同时 保存 和 更 新 某 个 实体 ， 如 果 有 了 单个 可 用 的 接口 时 就 无 需 两 个 目的 类 似 的 接口 
了 ， 因 为 接口 的 客户 端 想 要 做 的 只 是 持久 化 指定 的 实体 。 代 码 清单 8-10 展 示 了 重 构 后 的 接口 。 


代码 清单 8-10 ”ISave 接 口 的 实现 会 创建 新 的 实体 ， 也 会 适当 地 更 新 已 经 存在 的 实体 


public interface ISave<TEntity> 


{ 





void Save(TEntity entity); 
} 


经 过 这 次 重 构 后 ,你 就 可 以 针对 该 接口 添加 新 的 审计 修饰 器 了 。 每 当 用 户 保 存 一 个 实体 ， 你 
都 想 要 增加 一 些 元 数据 到 持久 存储 中 。 特别 是 有 关 触 发 保存 动作 的 用 户 身份 和 时 间 信 息 。 代码 清 
单 8-11 展 示 的 是 SaveAuditing 修 饰 器 。 
代码 清单 8-11 审计 修饰 器 内 部 使 用 了 两 个 ISave 接 口 


public class SaveAuditing<TEntity> : ISave<TEntity> 
{ 








private readonly ISave<TEntity> decorated; 

private readonly ISave<AuditInfo> auditSave; 

public SaveAuditing(ISave<TEntity> decorated, ISave<AuditInfo> auditSave) 
{ 

decorated; 

auditSave; 


this.decorated 
this.auditSave 





public void Save(TEntity entity) 
{ 
decorated.Save(entity); 
var auditInfo = new AuditInfo 
{ 
UserName = Thread.CurrentPrincipal.Identity.Name， 
TimeStamp = DateTime .Now 
再 


auditSave.Save(auditInfo); 


} 








SaveAuditing 修 饰 器 本 身 实现 了 ISave 接 口 , 但 也 需要 两 个 不 同 的 ISave 接 口 实 现 来 构造 修 
人 饰 器 本 身 。 第 一 个 必须 是 符合 修饰 器 的 TEntity 泛 型 类 型 参数 的 接口 实现 ， 用 来 完成 真正 的 保存 
工作 ( 当然 ， 也 可 以 用 来 进一步 修饰 完成 真正 保存 工作 的 实现 )。 第 二 个 接口 实现 只 针对 要 保存 
的 AuditInfo 类 型 。 虽 然 上 面 代码 清单 中 并 没有 展示 AuditInfo 类 型 的 定义 , 但 是 可 以 推断 它 应 
该 包含 string 类 型 的 UserName 属 性 和 DateTime 类 型 的 Timestamp 属 性 。 当 客户 端 调用 Save 方 法 
时 ,会 创建 一 个 新 的 AuditInfo 实 例 并 对 其 属性 进行 设置 。 在 保存 实体 数据 后 , 会 紧 跟 着 保存 该 
AuditInfo 实 例 包含 的 新 记录 数据 。 

同样 ， 客 户 端 代 码 应 该 不 清楚 这 些 细 市 ; 审计 动作 对 于 用 户 来 说 是 不 可 察觉 的 ， 同时 也 不 会 
影响 到 实体 数据 保存 的 实现 。 相 似 地 ，ISave<TEntity> 接 口 的 叶子 实现 (也 就 是 用 来 完成 实际 
保存 工作 的 , 没有 任何 修饰 的 实现 ) 本 身 既 不 知道 其 他 相关 修饰 器 的 存在 ,也 不 需要 为 任何 具体 
的 修饰 做 改动 。 

至 此 ， 原 来 的 单个 接口 已 经 变 为 了 三 个 独立 的 接口 ， 同 时 ， 每 个 接口 也 都 有 了 自己 特有 的 、 



































有 意义 的 、 具 有 实际 功能 的 修饰 希 。 图 8-2 展 示 的 UML 类 图 包括 了 分 离 原 有 接口 产生 的 三 个 新 接 


<<|NTERFACE> > 
IDelete 


口 和 相应 的 修饰 硕 。 


<<|NTERFACE> > 






|Save 
+ReadOne() 


+ReadAll() +Delete() 


1 

I 

1 
DeleteConfirmation 


+Delete() 





1 
1 
ReadCaching 


+ReadOnel() 
+ReadAll() 





图 8-2 ”接口 分 离 能 让 你 针对 必要 的 方法 做 修饰 ， 并 且 不 会 产生 元 余 


8.1.3 多重 接口 修饰 
前 面 章节 介绍 的 所 有 修饰 器 和 它们 修饰 的 接口 都 是 一 对 一 的 关系 。 这 是 因为 每 个 修饰 器 都 要 
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首先 实现 它 要 修饰 的 接口 。 但 是 你 可 以 配合 应 用 适 配 絮 和 修饰 妖 这 两 个 模式 来 构造 多 重修 饰 妖 ， 
同时 也 能 保证 代码 量 是 最 少 的 。 

你 要 创建 的 下 一 个 修饰 希 是 为 了 在 保存 或 删除 人 这 个 通知 允许 不 同 
的 订阅 者 根据 持久 存储 上 的 变更 做 出 不 同 的 啊 应 。 注 意 , 这 个 事件 通知 对 于 读 取 数据 而 言 是 没有 


多 大 用 处 的 ， 因 此 这 里 不 会 针对 IRead 接 口 进 行 修饰 。 
为 了 达到 这 个 目的 , 你 首先 需要 一 个 发 布 和 订阅 事件 通知 的 机 制 。 继 续 按 照 接 口 分 离 的 思 


分 解 ， 你 会 得 到 两 个 接口 ， 如 代码 清单 8-12 所 示 。 
代码 清单 8-12 分别 用 于 发 布 和 订阅 事件 通知 的 两 个 接口 


public interface IEventPublisher 











{ 
void Publish<TEvent>(TEvent Qevent) 
where TEvent : IEvent; 
} 
VS 
public interface IEventSubscriber 
{ 
void Subscribe<TEvent>(TEvent Qevent) 
where TEvent : IEvent; 
} 
示例 中 的 IEvent 接 口 非常 简单 ， 只 包含 一 个 string 类 型 的 Name 属 性 。 如 代码 清单 8-13 所 示 ， 


使 用 这 两 个 接口 ， 可 以 创建 在 一 个 实体 被 删除 时 发 布 相应 事件 通知 的 修饰 融 。 
代码 清单 8-13 ”这 个 修饰 带 会 在 实体 被 删除 时 发 布 一 个 事件 通知 


public class DeleteEventPublishing<TEntity> : IDelete<TEntity> 
{ 


private readonly IDelete<TEntity> decorated; 
private readonly IEventPublisher eventPublisher; 


public DeleteEventPublishing(IDelete<TEntity> decorated, IEventPublisher 
eventPublisher) 


{ 
this.decorated = decorated; 
this.eventPublisher = eventPublisher; 
} 
public void Delete(TEntity entity) 
{ 
decorated.Delete(entity); 
var entityDeleted = new EntityDeletedEvent<TEntity>(entity); 
eventPublisher.Publish(entityDeleted); 
} 
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到 这 一 步 ， 你 有 两 个 选择 : 要 人 么 在 单个 修饰 希 类 中 同时 文 持 IDelete 和 ISave 两 个 接口 ， 要 
么 再 为 TSave 接 口 单独 实现 一 个 发 布 事件 通知 的 修饰 希 。 代 码 清单 8-14 展 示 了 第 一 个 选项 的 实现 ， 
它 通 过 增加 新 的 Save 方 法 来 让 已 有 的 修饰 器 也 文 持 ISave 接 口 。 


代码 清单 8-14 ”两 个 修饰 带 可 以 在 一 个 类 中 实现 


public class ModificationEventPublishing<TEntity> : IDelete<TEntity>, ISave<TEntity> 
{ 

private readonly IDelete<TEntity> decoratedDelete; 

private readonly ISave<TEntity> decoratedSave; 

private readonly IEventPublisher eventPublisher; 


public ModificationEventPublishing(IDelete<TEntity> decoratedDelete, ISave<TEntity> 
decoratedSave, IEventPublisher eventPublisher) 


{ 
this.decoratedDelete = decoratedDelete; 
this.decoratedSave = decoratedSave ; 
this.eventPublisher = eventPublisher; 

} 

public void Delete(TEntity entity) 

{ 
decoratedDelete.Delete(entity); 
var entityDeleted = new EntityDeletedEvent<TEntity>(entity); 
eventPublisher.Publish(entityDeleted); 

} 

public void Save(TEntity entity) 

{ 
decoratedSave.Save(entity); 
var entitySaved = new EntitySavedEvent<TEntity>(entity); 
eventPublisher.Publish(entitySaved); 

} 





如 上 面 示例 所 示 , 只 有 在 多 个 修饰 器 共享 上 下 文 信息 时 , 在 单个 类 中 包含 多 个 修饰 需 的 实现 
才 是 有 意义 的 .ModificationEventPub1ishing 修 饰 器 为 它 实 现 的 ITSave 和 IDelete 两 个 接口 实 
现 相 同 的 发 布 事件 通知 的 功能 。 但 是 , 将 事件 发 布 和 审计 两 种 不 同 目的 的 修饰 需 结 合 在 同一 个 类 
实现 中 则 是 不 可 取 的 。 因 为 这 样 会 产生 不 必要 的 依赖 关系 ， 其 中 的 一 个 修饰 器 依赖 
IEventPub1isher 接 口 ， 而 另 一 个 则 依赖 AuditInfo 类 型 。 最 好 还 是 把 这 些 不 同 功能 的 实现 和 相 
应 的 依赖 链 分 别 封装 在 它们 各 自 的 程序 集中 。 


8.2 ”客户 痕 构 建 


接口 的 设计 (无 论 是 分 离 或 其 他 方式 产生 的 ) 会 影响 实现 接口 的 类 型 以 及 使 用 该 接口 的 客户 
端 。 如 果 客 户 端 要 使 用 接口 ， 就 必须 先 以 某 种 方式 获得 接口 实例 。 本 章 剩 余 的 绝 大 部 分 会 继续 以 
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手动 方式 构造 接口 实现 的 实例 , 并 把 它们 通过 构造 函数 参数 传递 给 客户 问 。 男 外 一 种 提供 接口 实 
例 的 方式 是 依赖 倒置 ， 下 一 革 会 对 它 进行 详细 讲解 。 

为 客户 端 提供 接口 实例 的 方式 一 定 程 度 上 取决 于 接口 实现 的 数目 。 如 有 果 每 个 接口 都 有 目 己 特 
有 的 实现 , 那 就 需要 构造 所 有 实现 的 实例 并 提供 给 客户 端 。 或 者 ， 如 果 所 有 接口 的 实现 都 包含 在 
单个 类 中 ,那么 只 需要 构建 该 类 的 实例 束 能 够 满足 客户 妆 的 所 有 依赖 。 











8.2.1 多 实现 、 多 实例 

继续 上 面 CRUD 的 示例 , 假设 IRead、ISave 和 IDelete 接 口 都 有 自己 独 有 的 实现 类 ,接口 分 
离 之 前 ， 想 使 用 CRUD 功 能 的 客户 端 只 需要 一 个 接口 ， 但 在 接口 分 离 之 后 ， 客 户 端 就 需要 同时 引 
用 这 三 个 接口 。 如 代码 清单 8-1$ 所 示 。 
代码 清单 8-15 “该 特定 于 订单 的 控制 需要 求 CRUD 的 每 个 方面 作为 一 个 单独 的 依赖 项 


public class OrderController 


{ 











private readonly IRead<Order> reader; 
private readonly ISave<Order> saver.; 
private readonly IDelete<Order> deleter; 


public OrderController(IRead<Order> orderReader, ISave<Order> orderSaver, 
IDelete<Order> orderDeleter) 


{ 
reader = orderReader; 
saver = orderSaver; 
deleter = orderDeleter; 
} 


public void CreateOrder (Order order) 





{ 

saver.Save(order); 
} 
public Order GetSingleOrder(Guid identity) 
{ 

return reader.ReadOne(identity); 
} 
public void UpdateOrder (Order order) 
{ 

saver.Save(order); 
} 
public void DeleteOrder(Order order) 
{ 

deleter.Delete(order); 
} 
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示例 中 的 控制 器 是 专门 针对 订单 实体 的 。 这 就 意味 着 提供 的 每 个 接口 都 要 以 0rder 类 作为 泛 
型 参数 。 如 果 你 要 在 任意 一 个 接口 中 使 用 另外 一 种 类 型 , 那么 该 接口 提供 的 操作 也 会 需要 同一 种 
类 型 。 比 如 ， 如 果 你 决定 将 删除 接口 参数 更 改 为 I[Delete<Customer>， 那 么 OrderController 
的 DeleteOrder 方 法 就 会 报错 ， 因 为 你 在 尝试 用 只 接受 Customers 的 方法 删除 一 个 0rder。 这 束 
是 强 类 型 和 泛 型 在 同时 起 作用 。 

控制 需 类 中 的 每 个 方法 都 需要 一 个 不 同 的 接口 来 执行 它 的 功能 。 为 了 清晰 起 见 ， 每 个 方法 都 
直接 调用 相应 接口 的 对 应 方法 。 当 然 ， 实 际 情 况 很 可 能 不 是 这 样 的 。 

顾名思义 ，0rderContro11er 只 处 理 0rder 类 。 当 然 ， 你 也 可 以 通过 让 每 个 接口 参数 泛 型 化 
来 实现 一 个 泛 型 化 的 控制 项。 如 代码 清单 8-16 所 示 。 


代码 清单 8-16 ”针对 实体 类 型 的 泛 型 化 控制 带 类 需要 每 个 CRUD 接 口 的 泛 型 参数 也 都 是 实体 类 型 


public class GenericController<TEntity> 


{ 




















private readonly IRead<TEntity> reader ; 
private readonly ISave<TEntity> Saver; 
private readonly IDelete<TEntity> deleter ; 


public GenericController(CIRead<TEntity> entityReader, ISave<TEntity> entity9aver， 
IDelete<TEntity> entityDeleter) 


{ 
reader = entityReader ; 
saver = entitySaver ; 
deleter = entityDeleter; 
} 
public void CreateEntity(TEntity entity) 
{ 
saver.Save(entity); 
} 
public TEntity GetSingleEntity(Guid identity) 
{ 
return reader.ReadOne(identity); 
} 
public void UpdateEntity(TEntity entity) 
{ 
saver.Save(entity); 
} 
public void DeleteEntity(TEntity entity) 
{ 
deleter.Delete(entity); 
} 





该 示例 中 的 控制 融和 代码 清单 8-15 中 的 版 本 只 是 略 有 不 同 , 但 是 使 用 二 者 的 客户 端 代码 量 却 


8.2 客户 端 构 建 231 





有 着 很 大 的 区 别 。 这 个 泛 型 化 的 控制 右 能 够 针对 任何 实体 实例 化 , 需要 的 三 个 接口 也 都 必须 使 用 
相同 的 实体 类 型 。 你 再 也 不 能 为 每 个 接口 提供 不 同 的 类 型 了 ， 比 如 ISave<Customer> 、 
IRead<Order>、IDelete<Lineltem>。 

两 个 版 本 的 控制 右 都 可 以 按照 大 致 相同 的 方式 创建 。 在 给 控制 带 构 造 函 数 传递 接口 实例 前 ， 
你 必须 要 先 实例 化 这 些 接口 的 相应 实现 。 如 代码 清单 8-17 所 示 。 


代码 清单 8-17 使 用 依赖 的 不 同 实例 来 创建 OrderController 


static OrderController CreateSeparateServices() 








{ 
var reader = new Reader<Order>() ; 
var saver = new Saver<Order>() ; 
var deleter = new Deleter<Order>(D) ; 
return new OrderController(reader, saver, deleter); 
} 
为 分 离 得 到 的 接口 分 别 创建 不 同 的 实现 类 , 实际 上 也 就 分 离 了 实现 OrderController 类 的 
关键 点 是 ， 它 的 三 个 参数 ( reader 、saver 和 delete ) 不 仅仅 是 代表 三 种 接口 ， 也 代表 了 三 种 


实现 类 。 
8.2.2” 单 实 现 、 单 实例 


为 外 一 种 实现 多 个 分 离 的 接口 的 方式 是 在 单个 类 中 继承 并 实现 它们 。 第 一 眼看 上 去 , 这 种 方 
式 也 许 有 些 反常 《毕竟 ， 接 口 分 离 的 目的 应 该 不 是 再 次 把 它们 统一 在 单个 实现 中 吧 ” )， 但 先 不 
要 着 急 。 代 码 清单 8-18 展 示 了 同时 实现 三 个 接口 的 单个 类 。 


代码 清单 8-18 所 有 接口 可 以 在 一 个 类 中 实现 


public class CreateReadUpdateDelete<TEntity> : 
IRead<TEntity>, ISave<TEntity>, IDelete<TEntity> 




















{ 
public TEntity ReadOne(Guid identity) 
{ 
return default(TEntity); 
} 
public IEnumerable<TEntity> ReadAl1Q 
{ 
return new List<TEntity>() ; 
} 
public void Save(TEntity entity) 
{ 
} 


public void Delete(TEntity entity) 
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{ 


} 
} 








切记 ,客户 端 根 本 不 知道 有 这 个 类 存在 。 在 编译 时 ， 客 户 端 代码 只 知道 它 所 需要 的 一 个 个 接 
口 。 不论 底层 接口 的 实现 是 否 还 有 其 他 可 用 的 操作 ， 对 于 客户 端 而 言 ， 每 个 接口 都 只 包括 接口 声 
明 的 成 员 。 这 也 是 接口 封装 和 隐藏 信息 的 方式 。 接 口 就 像 是 实现 类 上 的 小 窗口 ， 对 客户 端 屏蔽 了 
他 们 不 该 看 到 的 部 分 。 

即使 单个 类 同时 实现 所 有 接口 ， 上 一 节 基 于 多 实现 的 控制 器 示例 依然 是 有 效 的 , 因为 它 的 构 
造 函 数 参 数 都 是 对 应 的 接口 类 。 唯一 需要 改动 的 就 是 为 要 构造 的 控制 器 提供 参数 的 方式 。 如 代码 
清单 8-19 所 示 。 


代码 清单 8-19 尽管 下 面 的 示例 看 起 来 不 太 正常 ， 但 这 的 确 是 接口 分 离 已 知 的 副作用 之 一 


public OrderController CreateSingleService() 


{ 






































var crud = new CreateReadUpdateDelete<Order>(Q); 


return new OrderController(crud, crud, crud); 


} 


首先 , 你 只 需要 单个 CreateReadUpdateDelete 类 的 实例 。 该 类 同时 实现 了 三 个 接口 ， 因 此 
它 也 能 够 满足 控制 器 的 三 个 构造 函数 参数 的 要 求 。 

看 起 来 不 太 正 第 的 部 分 ( 三 个 参数 是 同一 个 实例 ) 也 是 合理 的 ， 因 为 每 个 参数 需要 的 是 该 类 
的 不 同方 面 。 这 是 接口 分 离 原则 产生 的 一 个 第 见 副 作用 。 

与 前 一 节 的 每 个 接口 都 有 相应 实现 的 方式 相 比 , 这 一 节 的 在 单个 类 内 实现 一 系列 相关 的 (但 
又 分 离 的 ) 接口 的 方式 并 不 那么 通用 。 后 者 通常 用 于 接口 的 叶子 实现 类 ,也 就 是 说 ， 既 不 是 修饰 
器 也 不 是 适配器 的 实现 类 ， 而 是 完成 实际 工作 的 实现 类 。 在 叶子 实现 类 上 应 用 这 种 方式 ,是 因为 
叶子 类 中 所 有 实现 的 上 下 文 是 一 致 的 。 无 论 你 是 在 使 用 NHibernate、ADO.NET 、Entity Framework 
或 者 其 他 的 持久 化 框架 , 叶子 实现 类 就 是 那些 直接 使 用 这 些 库 的 类 。 该 实例 中 的 所 有 操作 ( 读 取 、 
保存 或 删除 ) 都 是 依靠 这 些 库 来 完成 实际 工作 的 。 

有 些 修饰 需 和 适 配 需 也 会 同时 实现 一 组 分 离 的 接口 , 但 是 更 常见 的 是 为 它们 提供 各 个 接口 的 
独 有 实现 。 


8.2.3 ”超级 接口 反 模 式 


代码 清单 8-20 展 示 了 一 个 常见 的 错误 , 那 就 是 由 于 某 些 原因 又 把 分 离 得 到 的 多 个 接口 重新 统 
一 在 一 个 聚合 接口 下 。 通 党 这 样 做 是 为 了 避免 你 在 前 面 几 节 看 到 的 比较 别扭 的 多 个 接口 类 参数 的 
和 
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代码 清单 8-20 ”把 所 有 接口 分 离 得 来 的 接口 又 聚合 在 同一 个 接口 下 是 对 接口 分 离 原 则 的 错误 规避 


interface IInterfaceSoupAntipPattern<TEntity> : IRead<TEntity>, ISave<TEntity>, 
IDelete<TEntity> 
} 





这 些 接 口 一 起 聚合 构成 了 一 个 “超级 接口 ”, 但 这 显然 破坏 了 接口 分 离 带 来 的 好 处 。 这 种 超 
级 接口 的 实现 者 必然 需要 再 次 提供 所 有 操作 的 实现 ， 而 这 样 做 又 会 把 各 个 修饰 如 的 目标 混合 在 
一 起 。 


8.3 ”接口 分 离 


需要 单独 修饰 接口 的 能 力 (或 需求 ) 是 你 想 要 将 大 型 接口 分 割 为 多 个 小 型 接口 的 可 能 原因 之 
一 。 尽 管 如 此 ， 我 总 是 把 这 看 作 实 践 中 一 个 足够 好 的 原因 。 
应 用 接口 分 离 的 另外 两 个 原因 分 别 是 客户 端 和 架构 的 需要 。 














8.3.1 ”客户 端 需要 


一 般 情况 下 ,， 不 同 的 开发 人 员 会 处 理 不 同 部 分 的 代码 , 因此, 很 可 能 出 现 的 情况 是 ， 当 茶 个 
开发 人 员 使 用 另外 一 个 或 多 个 开发 人 员 提供 的 接口 时 , 他 们 的 工作 就 会 在 某 一 点 出 现 重 辣 。 逐 步 
地 详细 讲解 每 个 接口 不 仅 不 太 可 能 ， 也 是 不 切实 际 的 。 编 写 任何 代码 〈 特 别 是 充分 测试 的 代码 ) 
都 需要 时 间 ， 在 代码 基础 上 编写 扩展 的 文档 ， 即 使 是 为 最 终 用 户 ， 也 都 会 既 元 长 又 费时 。 相 反 ， 
更 好 的 办 法 应 该 是 尽早 采用 防御 方式 进行 编程 ， 以 此 阻止 其 他 开发 人 员 ( 其 至 包括 将 来 的 自己 ) 
无 意 中 使 用 你 的 接口 做 出 一 些 不 该 做 的 事情 。 

切记 ,客户 端 上 只 需要 它们 需要 的 东西 。 那些 巨型 接口 倾向 于 给 用 户 提 供 更 多 的 控制 能 力 。 带 
有 大 量 成 员 的 接口 允许 客户 端 做 很 多 操作 ， 甚 至 包括 它们 不 应 该 做 的 ， 这 样 的 接口 意图 很 模糊 ， 
焦点 不 明确 。 所 有 的 类 应 该 总 是 只 有 单个 清晰 的 职责 。 

代码 清单 8-21 展 示 了 一 个 允许 客户 端 和 用 户 设置 交互 的 接口 , 其 中 的 用 户 设 置 是 指 客户 端 为 
应 用 程序 用 户 界 面 设置 的 主题 。 这 个 特殊 场景 下 的 示例 会 令 你 感到 惊奇 , 尽管 它 是 一 个 只 有 一 个 
属性 的 接口 ， 然 而 依然 蝴 露 了 太 多 的 东西 给 客户 端 。 你 还 能 在 该 接口 上 做 进一步 的 分 离 吗 ? 


代码 清单 8-21 ”用户 配 置 接口 允许 访问 程序 当前 的 主题 


public interface IUserSettings 























{ 
string Theme 
{ 
get; 
set; 
} 


} 
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首先 ， 来 看 看 代码 清单 8-22 展 示 的 该 接口 的 实现 。 其 中 使 用 了 ConfigurationManager 类 来 
读 写 配置 文件 中 的 AppSettings 数 据 段 。 


代码 清单 8-22 一 个 从 配置 文件 中 加 载 设置 的 实现 


public class UserSettingsConfig : IUserSettings 


{ 
private const string ThemeSetting = "Theme"; 
private readonly Configuration config; 
public UserSettingsConfig() 
{ 
config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None); 
} 
public string Theme 
{ 
get 
{ 
return config.AppSettings.Settings[ThemeSetting] .Value; 
Set 
{ 
config.AppSettings.Settings[ThemeSetting] .Value = value; 
config.SaveQO; 
ConfigurationManager .RefreshSection("appSettings"); 
} 
} 
} 


实现 的 思路 很 清楚 了， 但 那 又 怎样 ? 恰好 有 两 个 该 接口 的 客户 闹 ， 其 中 一 个 只 想 读 取 数据 ， 
而 男 外 一 个 只 想 写 数据 。 这 正 是 问题 所 在 ， 如 代码 清单 8-23 所 示 。 


代码 清单 8-23 ”接口 的 不 同 客 户 问 以 不 同 的 目的 使 用 同一 个 属性 


public class ReadingController 








{ 
private readonly IUserSettings settings; 
public ReadingController(IUserSettings settings) 
{ 
this.settings = settings; 
} 
public string GetTheme() 
{ 
return settings.Theme ; 
} 
} 
7 


public class WritingController 
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{ 
private readonly IUserSettings settings ; 
public WritingController(IUserSettings settings) 
{ 
this.settings = settings; 
} 
public void SetTheme(string theme) 
{ 
settings.Theme = theme; 
} 
} 


与 期 望 的 一 样 ，ReadingController 类 只 使 用 了 Theme 属 性 的 读 取 器 ， 而 writing- 
Control11ler 类 则 只 使 用 了 Theme 属 性 的 设置 器 。 更 糟糕 的 是 , 由 于 接口 缺乏 分 离 , 你 将 无 法 阻止 
WritingControl1ler 获 取 主 题 数 据 ， 也 无 法 阻止 ReadingContro11er 修 改 主题 数据 ， 后 者 的 问 
题 更 大 。 

为 了 真正 防止 和 消除 错 用 接口 的 可 能 性 , 你 可 以 将 读 写 分 离 到 各 自 专 有 的 接口 中 ,如 代码 清 
单 8-24 所 示 。 


代码 清单 8-24 原 有 接口 被 一 分 为 二 : 一 个 负责 读 取 主 题 数据 ， 为 外 一 个 负责 修改 


public interface IUserSettingsReader 











{ 
string Theme 
{ 
get; 
} 
} 
yy 
public interface IUserSettingsWriter 
{ 
string Theme 
{ 
set; 
} 
} 








虽然 看 起 来 有 些 奇 怪 ， 但 这 绝对 是 有 效 的 C# 代 码 。 也 许 接口 只 提供 属性 的 恋 取 需 还 很 平 篆 ， 
但 是 属性 值 提 供 设置 器 的 情况 就 很 少见 了 。 

两 个 控制 器 现在 可 以 只 依赖 它们 实际 需要 的 接口 。 如 代码 清单 8-25 所 示 ，Reading- 
Controller 类 只 实现 了 IUserSettingReader 接口 ， 而 WritingController 类 只 实现 了 
IUserSettingWriter 接 口 。 
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代码 清单 8-25 ”这 两 个 接口 现在 分 别 只 依赖 它们 真正 需要 的 接口 


public class ReadingController 


{ 


private readonly IUserSettingsReader settings ; 


public ReadingController(IUserSettingsReader settings) 
{ 
this.settings = settings; 


} 


public string GetTheme() 
{ 
return settings.Theme; 
} 
} 
7 
public class WritingController 
{ 


private readonly IUserSettingsWriter settings ; 


public WritingController(CIUser9SettingsWriter settings) 
{ 
this.settings = settings; 


} 


public void SetTheme(string theme) 
{ 


settings.Theme = theme; 


} 





过 接口 分 离 , 你 已 经 防止 了 ReadingController 类 对 用 户 设置 的 修改 ,也 防止 了 Writing- 
Control1ler 类 对 用 户 设 置 的 读 取 。 因 此 ， 开 发 人 员 也 不 会 无 意 地 错 用 控制 需 来 完成 它们 不 应 该 
文 持 的 操作 。 

如 代码 清单 8-26 所 示 ， 依 然 使 用 ConfigurationManager 类 的 两 个 接口 的 实现 类 ， 只 需要 些 
许 改 动 即 可 。 


代码 清单 8-26 UsersSettingsConfig 类 现在 同时 实现 了 两 个 接口 ， 但 是 使 用 这 些 接口 的 客户 








端 对 此 并 不 知情 
public class UserSettingsConfig : IUserSettingsReader, IUserSettingsWriter 
{ 
private const string ThemeSetting = "Theme"; 


private readonly Configuration config; 


public UserSettingsConfig() 
{ 
config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None); 


} 
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public string Theme 


{ 
get 
{ 
return config.AppSettings.Settings[ThemeSetting] .Value; 
set 
{ 
config.AppSettings.Settings[ThemeSetting] .Value = value; 
config.SaveQO; 
ConfigurationManager.RefreshSection("appSettings"); 
} 
} 


} 


上 面 示 例 中 的 实现 类 ,除了 同时 继承 读 写 两 个 接口 外 , 与 前 面 代码 清单 8-22 中 的 该 类 完全 一 
致 。 记 住 ， 这 个 相同 的 实现 既 能 传递 给 ReadingController 类 ， 又 能 传递 给 WriterController 
类 ， 然 而 ， 这 两 个 类 上 的 接口 所 形成 的 窗口 会 让 相应 的 获取 和 设置 操作 变 得 不 可 用 。 

有 些 客户 端 能 读 但 不 能 写 的 需求 在 实际 中 很 常见 , 但 是 另外 一 个 能 写 却 不 能 该 的 场景 是 很 少 
见 的 。 要 处 理 这 种 情况 ， 你 可 以 先 分 离 读 接口 ， 然 后 让 写 接口 继承 读 接口 ， 而 不 是 采取 上 面 介绍 
的 完全 分 离 。 如 代码 清单 8-27 所 示 。 


代码 清单 8-27 ”通过 使 用 方法 代替 属性 ， 现 在 的 IUserSettingwriter 接 口 可 以 继承 IUser- 


SettingReader 接 口 

public interface IUserSettingsReader 
{ 

string GetTheme(); 
} 
0 
public interface IUserSettingsWriter : IUserSettingsReader 
{ 

void SetTheme(string theme); 
} 


为 了 做 到 这 一 点 ， 需 要 将 Theme 属 性 转化 为 GetTheme 和 SetTheme 这 两 个 方法 。 这 是 因为 C# 
还 不 能 很 好 地 支持 属性 继承 。 在 这 个 示例 中 ，C# 要 求 Theme 属 性 在 读 和 写 接口 中 都 要 有 。 尺 管 类 
能 够 很 好 地 实现 来 自 两 个 不 同 接口 的 一 个 接口 的 get 和 set 部 分 ， 但 不 地 的 是 ， 使 用 接口 继承 时 ， 
情况 并 非 如 此 。 当 接口 继承 中 出 现 属性 命名 冲突 时 , 编译 器 会 给 出 基 类 属性 会 被 子 类 属性 有 覆盖 隐 
藏 的 警告 。 这 样 就 无 法 达成 你 想 要 的 目的 。 也 不 要 使 用 编译 需 给 出 的 在 基 类 中 使 用 new 关 键 字 标 
记 属 性 的 建议 ， 因 为 那样 同样 无 法 继承 基 类 同名 属性 的 读 取 需 。 

此 时 ， 你 可 以 用 方法 实现 属性 同样 的 语法 功能 。GetTheme 方 法 和 Theme 属 性 的 读 取 需 一 样 ， 
SetTheme 方 法 则 与 Theme 属 性 的 设置 大 一 样 。 现 在 继承 的 结果 会 与 你 期 望 的 一 样 : 读 接 口 的 实施 
者 和 客户 端 都 只 能 访问 GetTheme 方 法 ， 而 写 接口 的 实施 者 和 客户 端 不 仅 能 访问 SetTheme 方 法 ， 
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也 能 访问 GetTheme 方 法 。 此 外 ， 任 何 IUserSettingsWriter 接 口 的 实现 都 自动 是 一 个 
IUserSettingsReader 接 口 的 实现 。 

代码 清单 8-28 展 示 了 对 WritingController 的 一 处 改动 : 在 设置 新 主题 前 检查 主题 是 否 被 改 
动 过 。 现 在 这 个 场景 是 合理 的 ， 因 为 用 户 设 置 的 改写 服务 同时 也 是 用 户 设 置 的 读 取 服务 。 这 种 情 
况 下 ， 就 无 需 单独 分 别 调用 读 和 写 这 两 个 接口 。 
代码 清单 8-28 WritingContro11er 类 通过 一 个 接口 就 能 同时 访问 读 取 器 和 设置 名 


public class WritingController 


{ 
private readonly IUserSettingsWriter settings ; 
public WritingController(CIUser9SettingsWriter settings) 
{ 
this.settings = settings; 
} 
public void SetTheme(string theme) 
{ 
if (settings.GetTheme() != theme) 
{ 
settings.SetTheme (theme); 
} 
} 
} 
授权 




















男 外 一 个 按照 客户 需求 来 做 接口 分 离 的 示例 是 , 应 用 程序 在 茶 个 特定 状态 下 只 能 提供 一 组 特 
定 的 操作 。 比 如 ， 根 据 登录 状态 ， 用 户 可 以 执行 的 操作 通常 会 是 不 同 的 。 
代码 清单 8-29 展 示 的 未 授权 接口 只 包括 匿名 且 未 授权 用 户 可 以 执行 的 操作 。 


代码 清单 8-29 ”该 接口 只 包含 匿名 用 户 可 以 执行 的 操作 


public interface IUnauthorized 


{ 








IAuthorized Login(string username, string password); 


void RequestPasswordReminder(string emai1Address) ; 





注意 到 ，Login 方 法 的 返回 值 是 另外 一 个 接口 类 。 返 回 该 接口 的 有 效 实 例 的 前 提 是 用 户 提供 
的 凭据 必须 完全 正确 ， 之 后 客户 端 就 可 以 执行 已 授权 的 操作 了 ， 如 代码 清单 8-30 所 示 。 


代码 清单 8-30 ”登录 后 ， 用 户 将 可 以 访问 已 授权 的 操作 


public interface IAuthorized 
{ 


void ChangePassword(string oldPassword, string newPassword); 
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void AddToBasket (Guid itemID) ; 
void Checkout(); 


void Logout(); 
} 


用 户 只 有 在 输入 凭据 且 成 功 经 过 授权 登录 后 ， 才 可 以 使 用 IAuthorized 接 口 提供 的 所 有 操作 。 
按照 客户 端 需求 进行 接口 分 离 能 够 阻止 开发 人 员 意 外 地 做 出 他 们 不 应 该 做 的 事情 ,在 上 面 的 示 
例 中 , 它 能 够 阻止 匿名 用 户 执行 已 授权 的 操作 。 当 然 , 总 会 有 些 意外 情况 , 但 是 通过 这 种 设计 可 以 
让 开发 人 员 认 识 到 ， 如 果 他 们 想 要 做 一 些 他 们 不 应 该 做 的 事情 ， 就 需要 改动 应 用 程序 的 核心 基础 。 


8.3.2” 染 构 需 要 


男 外 一 种 接口 分 离 的 驱动 力 来 自 于 架构 设计 , 高层 设 计 产 生 的 决定 对 底层 代码 的 组 织 有 着 非 
常 大 的 影响 。 

下 面 的 示例 中 ,高 层 设计 的 决定 是 采用 非 对 称 架构 。 与 前 面 几 节 展示 的 读 写 分 离 类 似 , 代码 
清单 8-31 展 示 的 IPersistence 接 口 包 含 了 一 些 查询 和 命令 的 组 合 。 


代码 清单 8-31 IPersistence 接 口 既 包括 命令 ， 也 包括 查询 


public interface IPersistence 


{ 
IEnumerable<Item> GetA11QO; 

















Item GetByID(Guid identity); 
IEnumerable<Item> FindByCriteria(string criteria); 
void Save(Item item); 


void Delete(Item item); 


} 








该 接口 的 非 对 称 架 构 就 是 命令 查询 贡 任 分 离 模式 的 一 部 分 。 这 里 再 次 出 现 分 离 ( segregation ) 
这 个 词 并 不 是 巧合 ， 因 为 这 个 架构 模式 本 身 的 意图 就 是 指导 你 去 做 一 些 接口 分 离 的 动作 。 
代码 清单 8-32 展 示 了 IPersistence 接 口 的 第 一 种 实现 。 


代码 清单 8-32 ” 当 命 令 和 查询 的 处 理 非 对 称 时 ， 实 现 一 片 混乱 


public class Persistence : IPersistence 

{ 
private readonly ISession session; 
private readonly MongoDatabase mongo; 








public Persistence(ISession session, MongoDatabase mongo) 
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{ 
this.session = session; 
this.mongo = mongo; 
} 
public IEnumerable<Item> GetA11(0) 
{ 
return mongo.GetCollection<Item>("items").FindAl1Q; 
} 
public Item GetByID(Guid identity) 
{ 
return mongo.GetCollection<Item>("items").FindOneById(identity.ToBson(O)); 
} 
public IEnumerable<Item> FindByCriteria(string criteria) 
{ 
var query = BsonSerializer.Deserialize<QueryDocument>(criteria); 
return mongo.GetCollection<Item>("Items").Find(query); 
} 
public void Save(Item item) 
{ 
using(var transaction = session.BeginTransaction()) 
{ 
session.Save(item); 
transaction.Commit(); 
} 
} 
public void Delete(Item item) 
{ 
using(var transaction = session.BeginTransaction()) 
{ 
session.Delete(item); 
transaction.Commit() ; 
} 
} 








示例 中 有 两 个 截然 不 同 的 依赖 : NHibernate 用 于 执行 命令 ，MongoDB 用 于 执行 查询 。 前 者 是 
一 个 配合 域 模 型 使 用 的 对 象 关系 映射 器 , 后 者 是 一 个 用 于 快速 查询 的 文档 存储 库 。 现在 这 个 类 型 
有 了 两 个 完全 无 关 的 依赖 ,因此 也 就 有 了 两 处 改变 点 。 因 为 依赖 的 不 同 , 所 以 依赖 相关 的 修饰 器 
也 很 有 可 能 不 同 。 这 里 不 会 像 前 面 的 CRUD 示 例 一 样 将 整个 接口 分 割 为 多 个 独立 的 小 操作 ， 而 只 
是 把 接口 一 分 为 二 : 命令 和 查询 。 图 8-3 中 的 UML 类 图 展示 了 重 构 后 的 结构 。 

将 命令 和 查询 分 离 到 各 自 的 接口 后 , 它们 的 实现 就 能 够 完全 依赖 各 自 必需 的 包 , 命令 接口 的 
实现 将 只 依赖 NHibernate 包 ， 而 查询 接口 的 实现 则 只 依赖 MongoDB 包 。 
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Controller 


+Load() 
+Savel() 


<<|NTERFACE> > 
ICommands 


+Savel() +GetByID!() 
人 +GetAll() 
+FindByCriteria() 


CommandsNHibernate 


+9ave() +GetByID!() 
+Delete() +GetAll() 
+FindByCriterial() 


图 8-3 ”根据 架构 需要 分 离 接 口 能 让 各 个 实现 带 有 自己 必需 的 依赖 
理想 情况 下 ， 这 两 个 接口 的 实现 不 仅仅 是 不 同 的 类 ， 而 且 也 会 依赖 不 同 的 包 (程序 集 )。 如 
果 依 然 有 着 相同 的 依赖 , 仅仅 通过 接口 分 离 只 能 解决 部 分 问题 。 因 为 它们 的 实现 和 各 目的 依赖 链 


是 相互 关联 的 ， 所 以 无 法 单独 重用 其 中 的 某 个 实现 。 
代码 清单 8-33 展 示 了 分 离 后 的 两 个 接口 。 现 在 可 以 分 别 实现 它们 了 。 


代码 清单 8-33 ”接口 分 离 为 了 查询 和 命令 方法 


public interface IPersistenceQueries 


MongoDB 











{ 
IEnumerable<Item> GetA11QO; 
Item GetByID(Guid identity); 
IEnumerable<Item> FindByCriteria(string criteria); 
} 
/0 
public interface IPersistenceCommands 
{ 
void Save(Item item); 
void Delete(Item item); 
} 





查询 接口 的 类 实现 和 前 面 的 Persistence 类 中 的 查询 部 分 实现 完全 一 样 , 只 是 不 再 包括 任何 
命令 相关 的 代码 ， 也 就 是 说 ， 没 有 任何 对 NHibernate 包 的 依赖 ， 如 代码 清单 8-34 所 示 。 


代码 清单 8-34 查询 实现 仅 依 赖 MongoDB 


public class PersistenceQueries : IPersistenceQueries 


{ 


private readonly MongoDatabase mongo; 
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public Persistence(MongoDatabase mongo) 


{ 
this.mongo = mongo; 
} 
public IEnumerable<Item> GetAl11(0) 
{ 
return mongo.GetCollection<Item>("items").FindAl1Q; 
J 
public Item GetByID(Guid identity) 
{ 
return mongo.GetCollection<Item>("items").FindOneById(identity.ToBson(O); 
} 
public IEnumerable<Item> FindByCriteria(string criteria) 
{ 
var query = BsonSerializer.Deserialize<QueryDocument>(criteria); 
return mongo.GetCollection<Item>("Items").Find(query); 
} 





同样 ， 命 令 接 口 的 类 实现 也 不 再 需要 任何 对 MongoDB 包 的 引用 ， 如 代码 清单 8-35 所 示 。 


代码 清单 8-35 ”命令 实现 仅 依赖 NHibernate 


public class PersistenceCommands : IPersistenceCommands 


{ 


private readonly ISession session; 
public PersistenceCommands(ISession session) 


{ 
this.session = session; 
} 
public void Save(Item item) 
{ 
using(var transaction = session.BeginTransaction()) 
{ 
session.Save(item); 
transaction.Commit() ; 
} 
} 


public void Delete(Item item) 

{ 
using(var transaction = session.BeginTransaction()) 
{ 


session.Delete(item); 


transaction.Commit() ; 
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8.3.3 ”单方 法 接口 


接口 分 离 会 生成 很 小 的 接口 。 接 口 规模 越 小 ， 就 变 得 越 通 用 。.NET Framework 中 有 很 多 作 
用 类 似 的 委托 ， 比 如 : Action 、Func 和 Predicate 等 。 但 是 ， 委 托 并 不 像 接 口 那 样 通用 。 尽 管 
委托 也 有 上 自己 的 用 途 ， 但 是 以 各 种 方式 分 离 产 生 的 接口 不 仅 可 以 被 修饰 和 适 配 ， 还 可 以 再 次 组 
合 。 因 为 接口 必须 实现 ， 在 同样 的 实现 类 中 也 可 以 通过 其 他 接口 或 构造 函数 参数 获得 更 多 的 上 
下 文 信息 。 

最 简单 的 接口 只 有 单个 方法 。 最 简单 的 方法 既 没 有 参数 也 没有 返回 值 。 如 代码 清单 8-36 所 示 。 


代码 清单 8-36 ”ITask 是 一 个 最 简单 的 接口 


public interface ITask 








void DoQO; 
} 





这 个 接口 非常 适合 修饰 。 因 为 它 没有 返回 值 ， 所 以 其 至 可 以 引用 异步 的 即 发 即 弃 修饰 器 。 客 
户 端 在 需要 发 送 消息 时 ， 如果 无 需 提供 任何 上 下 文 信息 并 且 无 需 等 待 任何 啊 应 , 就 可 以 使 用 这 个 
接口 。 

在 此 基础 上 改进 可 以 得 到 一 个 IAction 接 口 ， 它 和 .NET Framewotk 中 的 Action 委 托 有 些 类 
似 ， 需 要 一 个 泛 型 参数 来 表示 上 下 文 信息 。 如 代码 清单 8-37 所 示 。 


代码 清单 8-37 IAction 接 口中 增加 了 一 个 上 下 文 参数 


public interface IAction<TContext> 


{ 





void Do(TContext context); 
} 


IAction 只 是 比 ITask 复 杂 一 点 点 。 如 果 你 想 有 一 个 返回 值 而 不 是 参数 ， 你 就 创建 了 一 个 
IFunction 接 口 ， 如 代码 清单 8-38 所 示 。 


代码 清单 8-38 ”IFunction 接 口 有 返回 值 


public interface IFunction<TReturn> 


{ 
TReturn Do () ; 
} 


在 IFunction 接 口 基础 上 ， 如 果 你 需要 返回 一 个 布尔 值 。 那 么 你 就 得 到 了 一 个 IPredicate 
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接口 ， 如 代码 清单 8-39 所 示 。 
代码 清单 8-39 ”IPredicate 是 一 个 返回 布尔 值 的 函数 


public interface IPredicate 
{ 

bool Test() ; 
} 


IPredicate 接 口 可 以 用 于 封装 一 个 分 文 测 试 ， 比 如 一 个 if 语句 或 者 循环 中 的 判断 从 句 。 
尽管 这 些 接口 看 起 来 很 不 起 眼 , 但 是 通过 修饰 、 适 配 和 组 合 大 量 不 同 种 类 的 这 种 单方 法 接口 ， 
你 可 以 完成 很 多 复杂 的 事情 。 











8.4 ”总 结 


本 音 旨 在 介绍 如 何 设计 优秀 的 接口 。 很 多 时 候 , 接口 只 
外 观 。 在 某 些 临 界 点 ,接口 会 失去 它们 的 适应 能 力 ,而 这 些 
代码 基础 的 关键 因素 。 

应 该 分 离 接口 的 原因 有 很 多 ， 比 如 用 来 辅助 修饰 ,为 客户 端 隐藏 他 们 不 该 看 到 的 功能 ， 为 其 
他 开发 人 员 提 供 自 文 档 ， 以 及 作为 架构 设计 的 产物 等 。 无 论 是 哪 种 原因 ， 你 都 应 该 在 创建 任何 接 
口 时 记得 接口 分 离 这 个 技术 原则 。 与 大 多 数 编程 工具 一 样 , 最 好 是 从 开始 阶段 就 应 用 接口 分 离 原 
则 ， 而 不 是 到 了 后 期 才 去 蔷 吉 地 重 构 。 


是 隐藏 在 它们 后 面 的 大 规模 子 系统 的 
适应 能 力 正 是 让 接口 成 为 开发 SOLID 




















依赖 注入 原则 





完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 理解 依赖 注入 的 重要 性 。 

口 用 依赖 注入 将 SOLID 代 码 组 织 在 一 起 。 

D 在 穷人 的 依赖 注入 、 控 制 反 转 容器 或 约定 优 于 配置 这 三 种 方式 中 选择 其 一 。 

D 避免 依赖 注入 反 模 式 。 

D 围绕 组 合 根 和 解析 根来 组 织 你 的 解决 方案 。 

D 知道 如 何 正确 地 结合 工厂 模式 和 依赖 注入 来 管理 对 象 的 生命 周期 。 

依赖 注入 ( Dependency Injection，DI ) 是 一 个 非常 简单 的 概念 ， 实 现 起 来 也 很 简单 。 尽 管 如 
此 ， 这 种 简单 性 却 掩盖 了 该 模式 的 重要 性 。 没 有 依赖 注入 ,前面 几 章 介绍 的 SOLID 技 术 ( 以 及 前 
面 与 敏捷 基础 相关 的 章节 ) 都 不 可 能 实际 应 用 。 

当 某 些 事情 很 简单 也 很 重要 时 ， 人 们 就 会 将 它 过 度 复杂 化 。 依 赖 注入 也 一 样 , 但 是 在 应 用 它 
时 ， 的 确 有 几 个 陷阱 要 留意 。 这 些 陷 阱 包括 混淆 该 模式 意图 的 各 种 反 模 式 和 不 良 习惯 。 

正确 实现 的 依赖 注入 对 于 项 目的 绝 大 多 数 代码 而 言 是 不 可 见 的 ,它们 被 局 限 在 一 个 很 小 的 代 
码 范围 内 , 通常 是 在 一 个 独立 的 程序 集 内 。 最 好 是 从 一 开始 就 应 用 依赖 注入 ， 因 为 在 已 经 建立 的 
项 目 中 引入 依赖 注入 会 既 困 难 又 耗 时 。 


9.1 简单 的 开始 


下 面 的 示例 会 突出 展示 依赖 注入 能 够 解决 的 潜在 问题 。 假设 你 在 开发 一 个 用 户 可 以 用 来 管理 
待 办 事项 清单 的 任务 管理 应 用 程序 。 此 外 ,还 假定 此 时 项 目 依然 处 于 早期 的 开发 阶段 ， 同时 也 决 
定 了 使 用 WPF 开 发 用 户 界面 。 此 时 , 你 已 经 有 了 一 个 只 能 从 持久 存储 中 读 取 并 显示 待 办 事项 列表 
的 主 徐 口 。 如 图 9-1 所 示 。 

因为 是 一 个 WPF 应 用 程序 ， 你 正在 使 用 模型 -视图 -视图 模型 ( Model-View-ViewModel， 
MVVM ) 模式 确保 隔离 各 个 层 之 间 的 依赖 。 虽 然 还 没有 使 用 依赖 注入 ， 但 是 该 应 用 程序 已 经 在 
努力 使 用 其 他 的 最 佳 实践 。 其 中 的 一 个 视图 模型 是 主 窗口 的 后 台 控 制 絮 。TaskListController 
类 实例 委托 一 个 TaskService 类 实例 来 获取 所 有 代办 事项 数据 。 代 码 清单 9-1 展 示 了 一 个 在 没有 
应 用 依赖 注入 的 情况 下 达到 设计 目的 的 实例 。 
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ID Description Pnority DueDate Completed 
10/4/2013 8:4537PM| ”加 


Paythebils |HiGH |10/5/201384537PM| 加 
Washthedog |MED |10/6/201384537PM| 加 | 
lBookfiights [HlGH |10/6/201384537PM| 加 
Buy presents |HIGH |107/201384537PM| 加 
Postletters |MED |107/201384537PM| 加 
Writeemails JlOW |107/201384537PM| 加 
[Readarides JlOW |i0/8/201384537PM| 加 
Skypefomily |HIGH |10/8/201384537PM| 加 
Take outwife |HIGH |10/9/201384537PM| 回 
10|Writebook |HlGH liv3/20384537PM| 加 | 
ee ee ss 


国 划 


回 | 国 | 国 | 国 | 国 | 国 | 国 国 


回 








回 








图 9-1 除了 描述 外 ， 待 办 事项 还 包括 了 优先 级 、 截 止 日 期 和 完成 情况 等 状态 


代码 清单 9-1 控制 融 并 没有 使 用 依赖 注入 


{ 
public event PropertyChangedEventHandler PropertyChanged = delegate { }; 


private readonly ITaskService taskService; 
private readonly IObjectMapper mapper.; 
private ObservableCollection<TaskViewModel> allTasks; 


public TaskListControllerQ 
{ 


this.taskService = new TaskServiceAdoQO; 
this.mapper = new MapperAutoMapper O; 


var taskDtos = taskService.GetAllTasks(); 
AllTasks = new 
ObservableCollection<TaskViewModel1l>(mapper.Map<IEnumerable<TaskViewModel>>(taskDtos)); 


} 
public ObservableCollection<TaskViewModel> AllTasks 
{ 
get 
{ 
return allTasks; 
} 
set 
{ 
allTasks = value; 
PropertyChanged(this, new PropertyChangedEventArgs("AllTasks")); 
} 
} 
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上 面 示 例 中 的 实现 方式 存在 如 下 一 些 问 题 。 

口 很 难 做 单元 测试 ， 因 为 控制 带 依 赖 时 个 具体 实现 。 

口 不 清楚 视图 模型 的 依赖 点 ， 除 非 查看 它 的 源 代码 。 

口 隐 式 地 依赖 服务 的 所 有 依赖 。 

口 无 法 灵活 地 符 换 服务 实现 。 

本 节 的 剩余 内 容 会 通过 对 比 原始 类 和 应 用 依赖 注入 的 重 构 版 本 来 逐个 逆 和 人 放 析 这 些 问 题 。 代 
码 清单 9-2 展 示 了 应 用 了 依赖 注入 的 重 构 版 本 ， 其 中 的 改动 已 经 加 粗 。 


代码 清单 9-2 重 构 后 ， 控 制 如 使 用 了 依赖 注入 


public class TaskListController : INotifyPropertyChanged 
{ 








public event PropertyChangedEventHandler PropertyChanged = delegate { }; 


private readonly ITaskService taskService; 
private readonly IObjectMapper mapper; 
private ObservableCollection<TaskViewModel> allTasks; 


public TaskListController(ITaskService taskService, IObjectMapper mapper) 
{ 

this.taskService = taskService; 

this.mapper = mapper:; 


} 


public void OnLoad() 
{ 
var taskDtos = taskService.GetAllTasksQO; 
AllTasks = new 
ObservableCollection<TaskViewMode1l>(mapper.Map<IEnumerable<TaskViewMode1>>(taskDtos)); 





} 
public ObservableCollection<TaskViewModel> AllTasks 
{ 
get 
{ 
return allTasks; 
set 
{ 
allTasks = value; 
PropertyChanged(this, new PropertyChangedEventArgs("AllTasks")); 
} 
} 


要 单独 测试 代码 清单 9-1 中 的 TaskListController 类 的 第 一 个 版 本 ， 就 需要 模拟 Task- 
Service 类 。 然而， 很 难 通过 常规 方式 去 模拟 TaskService 类 ， 而 TaskService 类 并 不 是 个 可 代 
理 的 类 , 或 者 说 你 应 该 把 它 改造 成 可 代理 的 。 代码 清 单 9-2 中 是 TaskListController 类 的 第 二 个 
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版 本 ， 它 仅 接 受 ITaskService 接 口 ， 而 不 是 像 第 一 个 版 本 中 那样 直接 依赖 某 个 实现 类 。 这 样 重 
构 后 就 更 容易 测试 了 了， 因为 接口 实例 总 是 可 以 被 蔡 换 的 。 


注意 ”只 有 能 为 用 户 提供 替换 实现 (也 称 为 代理 ，proxy ) 的 类 才 称 之 为 是 可 代理 的 。 可 代 
理 的 类 必须 把 所 有 方法 声明 为 虚 方 法 ， 而 接口 总 是 直接 可 代理 的 。 





如 有 果 一 个 类 在 它 的 方法 内 部 能 随意 构造 类 的 实例 , 你 束 无 法 从 外 部 知道 该 类 到 底 需 要 什么 才 
可 以 正 稼 工作 。 没 有 应 用 依赖 注入 的 第 一 个 示例 就 是 一 个 依赖 的 黑 盒子 。 你 只 有 通过 查看 类 实现 
的 源 代码 才能 知道 真相 ,因为 它 没有 通过 该 类 的 接口 或 者 方法 签名 声明 任何 依赖 。 第 二 个 示例 中 
应 用 了 依赖 注入 , 它 清楚 地 表明 了 需要 一 个 任务 服务 的 实现 才能 正常 工作 。 客 户 端 代码 可 以 通过 
Visual Studio 的 智能 感知 特性 看 到 构造 郧 数 的 签名 。 

当 类 A 和 类 B 之 间 存 在 依赖 关系 时 ， 如 果 类 B 依 赖 类 C, 那么 类 A 也 隐 式 地 依赖 类 C。 随从 反 模 
式 就 是 这 样 引 入 了 交错 复杂 的 依赖 关系 网 ， 而 这 种 依赖 关系 网 一 旦 形成 ,就 很 难 青 整理 清楚 。 如 
果 你 能 确保 你 的 接口 对 自己 行为 做 了 正确 的 抽象 , 那么 客户 在 使 用 该 接口 时 就 不 再 需要 其 他 任何 
东西 了 。 即 使 该 接口 的 实现 可 能 依赖 了 一 些 大 型 的 外 部 组 件 ， 比 如 数据 库 ， 也 不 会 影响 到 使 用 该 
接口 的 客户 端 代 码 。 这 就 是 正确 应 用 阶梯 模式 的 结果 。 

直接 实例 化 实现 对 象 ， 你 也 会 失去 接口 能 提供 的 另外 一 个 扩展 能 力 : 你 将 无 法 继承 
TaskService 类 并 增强 已 有 方法 的 功能 。 即 使 方法 已 经 被 声明 为 虚 方 法 也 一 样 , 因为 无 论 如 何 你 
都 要 改动 客户 端 代码 去 直接 实例 化 这 个 派生 的 子 类 ,接口 允许 应 用 各 种 强大 的 模式 来 为 自己 提供 
多 种 实现 或 增强 现 有 的 实现 。 此 外 你 也 已 经 知道 ， 即 使 接口 的 初始 版 本 类 实现 已 经 编写 好 ， 只 要 
新 的 接口 需求 还 没 出 现 , 现 有 接口 的 这 种 允许 增加 新 的 实现 或 增强 现 有 实现 的 扩展 能 力 是 一 直 存 
在 的 。 这 也 是 代码 适应 能 力 的 关键 点 。 


9.1.1 任务 列表 应 用 


图 9-2 展 示 了 你 使 用 任务 列表 应 用 想 要 实现 的 包 级 别 和 类 级 别 组 织 。 

用 户 界 面 层 包 括 了 WPF 、 控 制 器 以 及 视图 模型 相关 的 代码 。 服 务 层 通过 一 个 接口 对 控制 器 的 
依赖 进行 了 抽象 ， 它 的 实现 简单 地 使 用 了 ADO.NET 来 从 持久 存储 中 获取 所 有 任务 数据 。 

服务 实现 返回 的 TaskDto 类 是 从 存储 中 获取 的 一 行 任务 数据 在 内 存 中 的 表示 。 这 只 是 一 个 普 
通 的 CLR 对 象 ( Plain Old CLR Object，POCO ), 就 其 本 和 刁 而 言 ， 它 并 不 具备 WPF 视 图 模型 应 有 的 
丰富 功能 。 因 此 ， 当 TaskController 类 从 ITaskService 接 口 获取 TaskDto 类 的 对 象 时 ， 它 会 请 
求 一 个 I0ObjectMapper 接 口 来 把 这 些 TaskDto 类 的 对 象 转换 为 TaskViewMode1 类 的 对 象 , 后 者 实 
现 了 INotifyPropertyChanged 接 口 ， 所 以 可 以 与 其 他 的 视图 相关 的 特性 结合 使 用 。 

代码 清单 9-3 展 示 了 ITaskServi ce 接口 的 ADO.NET 实 现 。 你 主要 会 担心 的 是 类 的 构造 函数 ， 
此 外 ， 本 和 章 后 面 还 会 讨论 这 个 类 中 另 一 个 很 难 消除 的 代码 味道 。 
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TaskViewModel <<INTERFACE>> 
INotifyPropertyChanged 


+Priority 


+Description 
TaskController De -memberName 


-taskService +Completed 


+ViewModel 


Service 


<<CLASS>> ADO.NET 


TaskDto 


+Priority 
+Description 
+DueDate 
+Completed 


图 9-2 分 三 层 的 任务 列表 应 用 的 UML 类 图 ， 包 含 包 


代码 清单 9-3 ”TaskService 负 责 检索 任务 列表 数据 


public class TaskServiceAdo : ITaskService 


{ 


public TaskServiceAdo(ISettings settings) 
1 


this.settings = settings; 


public IEnumerable<TaskDto> GetAllTasks©Q 
{ 


var allTasks = new List<TaskDto>() ; 


private readonly ISettings settings; 


private const int IDIndex = 0; 
private const int DescriptionIndex = 1; 
private const int PriorityIndex = 2; 
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private const int DueDateIndex = 3; 
private const int CompletedIndex = 
using(var connection = new 
SqlConnection(settings.GetSetting("TaskDatabaseConnectionString"))) 

{ 


4; 


connection.0pen() ; 


using(var transaction = connection.BeginTransaction()) 
{ 
var command = connection.CreateCommand(Q); 
command.Transaction = transaction; 
command.CommandType = CommandType.StoredProcedure; 
command.CommandText = "[dbol].[get all_tasks]"; 


using(var reader = command.ExecuteReader(CommandBehavior.CloseConnection)) 


{ 


if (reader.HasRows) 
{ 
while (reader.Read()) 


{ 
allTasks.Add( 

new TaskDto 

{ 
ID = reader.GetInt32(IDIndex), 
Description = reader.GetString(DescriptionIndex), 
Priority = reader.GetString(PriorityIndex), 
DueDate = reader.GetDateTime(DueDateIndex), 
Completed = reader.CetBoolean(CompletedIndex) 


} 


return allTasks; 


ISettings 接 口 从 TaskService 类 中 抽象 了 获取 连接 字符 串 的 细 市 。 该 接口 的 一 个 可 能 实现 
就 是 直接 适 配 Microsoft .NET Framework 提 供 的 ConfigurationManager 类 。 不 难 想象 代码 中 某 处 
肯定 会 使 用 ISettings 接 口 来 存储 设置 数据 。 另 外 一 个 问题 就 是 ConfigurationManager 类 是 静 
态 的 ,因此 难以 进行 模拟 。 直 接 使 用 该 静态 类 会 给 获取 诸如 连接 字符 串 等 应 用 程序 配置 囊 来 局 限 ， 
也 会 降低 TaskServiceAdo 类 的 可 测 性 。 


9.1.2” 对象 图 的 构建 
本 书 前 面 已 经 多 次 提 到 ， 接 口 实例 要 注 和 人 到 构造 函数 中 。 当 然 ， 只 注入 接口 实例 是 不 够 的 ， 
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你 还 必须 要 提供 一 个 接口 的 实现 。 有 两 种 主要 的 注入 方式 : 穷人 的 依赖 注入 和 控制 反 转 容器 。 为 
了 展示 依赖 注入 的 工作 原理 ， 本 节 会 先 讲解 穷人 的 依赖 注入 。 

1. 穷人 的 依赖 注入 

顾名思义 ， 穷 人 的 依赖 注入 (Poor Man’s Dependency Injection )， 这 个 模式 不 需要 任何 其 他 
外 部 依赖 就 可 以 实现 注入 。 它 需要 提前 为 控制 器 创建 必需 的 对 象 图 。 代 码 清单 9-4 展 示 了 如 何 构 
建 重 构 后 的 TaskListController 类 以 及 如 何 给 它 传递 作为 应 用 程序 主 窗口 的 TaskListView 类 
实例 。 


代码 清单 9-4 穷人 的 依赖 注入 比较 紧 琐 但 却 很 灵活 


public partial class App : Application 





{ 
private void OnApplicationStartup(object sender, StartupEventArgs e) 
{ 
CreateMappings() ; 
var settings = new Application9Settings() ; 
var taskService = new TaskServiceAdo(settings); 
var objectMapper = new MapperAutoMapperQ); 
controller = new TaskListController(taskService, objectMapper); 
MainWindow = new TaskListView(controller); 
MainwWindow.Show() ; 
controller.OnLoadQO; 
} 
private void CreateMappings() 
{ 
AutoMapper .Mapper .CreateMap<TaskDto, TaskViewModel1>(); 
} 
private TaskListController controller; 
} 


示例 代码 是 你 的 应 用 程序 人 口 。0nApp1icationStartup 方 法 是 一 个 WPF 内 部 事件 处 理 器 ， 
用 它 来 完成 一 些 事情 的 初始 化 。 尽 管 不 同类 型 的 应 用 程序 的 入口 代码 会 有 所 不 同 , 但 是 它 始终 是 
一 个 放置 依赖 注入 代码 的 好 地 方 。 

应 用 程序 入口 的 引导 过 程 很 简单 。 目 标 是 创建 一 个 TaskListView 类 实例 ， 因 为 这 个 视图 类 
是 整个 应 用 程序 解决 方案 的 解析 根 。 解 析 根 会 在 本 童 后 面 做 详细 介绍 。 为 了 创建 TaskListView 
类 ， 你 首先 要 需要 一 个 TaskListController 实 例 。 而 后 者 叉 需 要 一 个 ITaskService 接 口 实例 
和 一 个 IO0bjectMapper 接 口 实例 , 所 以 , 你 又 得 先 初 始 化 这 两 个 接口 的 实例 ， 此 时 你 就 需要 提供 
这 个 接口 的 实现 了 。 而 ITaskService 接 口 的 实现 类 TaskServiceAdo 又 需要 一 个 ISettings 接 口 
的 实现 ， 所 以 你 需要 先 提 供 一 个 App1icationSettings 类 的 实例 。App1icationSettings 类 本 
身 则 是 .NET Framework 中 的 ConfigurationManager 类 的 一 个 适配器 。 图 9-3 中 的 UML 类 图 说 明 
了 这 些 依赖 。 
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图 9-3 ”任务 列表 应 用 程序 由 一 组 接口 、 接 口 的 实现 以 及 相关 的 依赖 构成 


每 个 类 都 依赖 一 个 或 多 个 可 能 也 需要 依赖 的 其 他 类 。 诸 如 MapperAutoMapper 类 和 








ApplicationSettings 类 之 类 的 适 配 带 实现 很 常见 ， 它 们 通常 只 满足 接口 需要 的 依赖 ,但 实际 
上 依然 是 委托 其 他 类 完成 实际 工作 。 即 使 不 是 适 配 带 的 类 , 也 会 委托 自己 的 一 些 依赖 来 做 一 些 工 
作 ， 比 如 TaskServcieAdo 类 ， 它 实际 上 是 使 用 ADO.NET 直 接 获 取 数 据 。ITaskService 接 口 的 
其 他 实现 可 以 从 其 他 地 方 获取 数据 ， 比 如 ， 可 以 实现 一 个 主要 委托 NHibernate 完成 实际 动作 的 
TaskServiceNHibernate 类 。 此 外 , 也 可 以 实现 一 个 依赖 Microsoft Outlook 插 件 框架 的 从 Outlook 
内 置 的 任务 清单 中 读 取 任务 数据 的 TaskServcie0ut1ook 类 。 再 强调 一 遍 ， 只 要 符合 接口 的 任何 
东西 都 可 以 是 任务 的 数据 源 ， 因 为 接口 本 身 从 不 会 把 自己 和 任何 具体 的 实现 技术 绑 定 在 一 起 。 

穷人 的 依赖 注入 会 比较 见长 。 当 该 应 用 程序 要 扩展 支持 增加 新 任务 、 编 辑 任 务 以 及 可 能 的 任 
务 提醒 功能 时 ,你 会 很 容易 预见 ， 为 依赖 注入 构造 各 种 实例 的 代码 会 快速 增长 , 慢 慢 地 ,它们 就 
会 变 得 不 是 那么 容易 理解 了 。 尽 管 如 此 , 穷人 的 依赖 注入 方式 仍然 很 灵活 。 无 论 你 要 构造 多 么 复 
杂 的 对 象 图 ,构造 的 方式 都 是 清 清 楚楚 的 。 因 为 方式 只 有 一 种 : 手动 创建 任何 需要 的 实例 ， 然 后 
把 它们 传递 给 聚合 它们 功能 的 类 , 重复 这 个 动作 直到 成 功 实例 化 应 用 程序 的 解析 根 。 在 这 里 ,你 
可 以 为 要 实例 化 的 类 所 依赖 的 接口 应 用 任何 意图 的 修饰 需 , 也 就 是 说 , 穷人 的 依赖 注入 允许 你 去 
征 意 定制 要 构建 的 对 象 网 。 

2. 方法 注入 

不 只 是 构造 函数 可 以 为 类 注 人 依赖 项 。 方 法 和 属性 成 员 也 都 可 以 ,只 是 它们 和 构造 函数 的 使 
用 场景 有 所 不 同 。 
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代码 清单 9-5 展 示 了 再 次 重 构 的 TaskListController 类 , ITaskService 接 口 的 GetAllTasks 
方法 参数 可 以 接受 ISettings 接 口 实例 的 注入 。 这 需要 改动 TTaskService 接 口 的 方法 签名 。 


代码 清单 9-5 现在 ,任务 服务 实例 是 从 方法 的 参数 中 获取 设置 实例 ， 而 不 是 从 构造 函数 的 参数 
中 获取 
public class TaskListController : INotifyPropertyChanged 
{ 
public TaskListController(ITaskService taskService, IObjectMapper mapper, ISettings 
settings) 
{ 
this.taskService = taskService; 
this.mapper = mapper; 
this.settings = settings; 


} 


public void OnLoad (0) 
{ 
var taskDtos = taskService.GetAllTasks(settings); 
AllTasks = new 
ObservableCollection<TaskViewModel1l>(mapper.Map<IEnumerable<TaskViewMode1>>(taskDtos)); 


} 


如 果 只 有 该 方法 需要 这 个 依赖 时 ,从 方法 参数 注入 依赖 会 很 有 用 。 从 构造 函数 注入 依赖 表明 
类 中 的 多 数 行为 需要 该 依赖 项 , 但 是 如 果 只 有 少 部 分 方法 需要 某 个 依赖 , 从 各 个 方法 参数 注入 该 
依赖 会 更 好 。 方 法 注入 方式 也 有 缺点 ， 那 就 是 ， 用 户 在 调用 方法 前 必须 要 先 准 备 好 依赖 的 实例 。 
客户 端 可 以 通过 构造 函数 或 者 方法 参数 沿 着 调用 栈 一 直 将 依赖 实例 传递 给 需要 使 用 该 依赖 的 目 
标 类 。 

3. 属性 注入 

与 方法 注入 类 似 ， 属 性 也 可 以 用 于 注入 依赖 。 代 码 清单 9-6 展 示 了 再 次 重 构 的 TaskList- 
Control1ler 类 。 这 里 的 ITaskService 接 口 改 用 属性 Settings 来 注入 依赖 。 再 说 一 次 ， 要 切记 ， 
需要 同时 改动 接口 和 实现 来 文 持 相应 的 属性 。 


代码 清单 9-6 ”也 可 以 通过 属性 来 完成 依赖 注入 的 动作 


public class TaskListController : INotifyPropertyChanged 
{ 

















public TaskListController(ITaskService taskService, IObjectMapper mapper, ISettings 
settings) 
{ 
this.taskService = taskService; 
this.mapper = mapper; 
this.settings = settings; 


} 


public void OnLoad (0) 
{ 
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taskService.Settings = settings; 
var taskDtos = taskService.GetAllTasksQ; 
AllTasks = new 
ObservableCollection<TaskViewModel1l>(mapper.Map<IEnumerable<TaskViewModel>>(taskDtos)); 
} 
} 





这 种 方式 的 好 处 是 可 以 在 运行 时 改变 属性 实例 值 。 从 构造 函数 注入 的 依赖 实例 在 类 的 整个 生 
命 周 期 内 都 可 以 使 用 ， 而 从 属性 注入 的 依赖 实例 还 能 从 类 生命 周期 的 菏 个 中 间 点 开始 起 作用 。 


9.1.3 ”控制 反 转 


本 书 通 篇 的 示例 都 展示 这 样 的 场景 : 开发 中 的 类 委托 某 些 抽象 完成 动作 , 而 这 些 被 委托 的 抽 
象 又 被 其 他 的 类 实现 , 这 些 类 又 会 去 委托 其 他 一 些 抽象 完成 某 些 动作 。 最 终 ， 在 依赖 链 终结 的 地 
方 ， 都 是 一 些小 旦 直接 的 类 ,它们 已 经 不 需要 任何 依赖 了 。 要 构造 有 依赖 项 的 类 ， 首 先 要 构造 并 
注入 这 些 依赖 项 ,你 已 经 知道 如 何 通 过 手动 构造 类 实例 并 把 它们 传递 给 构造 函数 的 方式 来 实现 依 
赖 注入 的 效果 。 尺 管 这 种 方式 已 经 可 以 让 你 任意 蔡 换 或 修饰 依赖 的 实现 , 但 是 构造 的 实例 对 象 图 
依然 是 静态 的 ， 也 就 是 说 ， 编 译 时 就 已 经 确定 了 的 。 控 制 反 转 ( Inversion of Control，IoC ) 允许 
你 将 构建 对 象 图 的 动作 推迟 到 运行 时 。 

控制 反 转 的 概念 通常 都 是 在 控制 反 转 容器 (container ) 的 上 下 文中 出 现 。 控 制 反 转 容 需 组 成 
的 系统 能 够 将 应 用 程序 使 用 的 接口 和 它 的 实现 类 关联 起 来 , 并 能 在 获取 实例 的 同时 解析 所 有 相关 
的 依赖 。 

代码 清单 9-7 中 展示 的 应 用 程序 人 口 代 码 中 使 用 了 Unity 控 制 反 转 容器 。 代 码 的 第 一 步 就 是 初 
始 化 得 到 一 个 UnityContainer 实 例 。 注 意 ， 示 例 代 码 中 这 样 实例 化 控制 反 转 容 需 是 在 直接 实例 
化 基础 组 件 ， 在 后 期 想 蔡 换 为 其 他 容 需 会 比较 困难 。 


代码 清单 9-7 ”示例 中 没有 使 用 手动 构造 实现 的 实例 ， 而 是 通过 使 用 控制 反 转 容 豆 来 建立 类 和 接 
口 的 映射 关系 


public partial class App : Application 

{ 
private IUnityContainer container; 
private void OnApplicationStartup(object sender, StartupEventArgs e) 
{ 





























CreateMappings O; 


container = new UnityContainer() ; 
container.RegisterType<ISettings, ApplicationSettings>(Q); 
container.RegisterType<IObjectMapper, MapperAutoMapper>QO; 
container.RegisterType<ITaskService, TaskServiceAdo>QO; 
Container.RegisterType<TaskListController>() ; 
container.RegisterType<TaskListView>(); 


MainWindow = container.Resolve<TaskListView>0Q; 
MainWindow. ShowO); 
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((TaskListController)MainWindow.DataContext) .OnLoad() ; 


} 
private void CreateMappings() 
{ 
AutoMapper .Mapper .CreateMap<TaskDto, TaskViewModel1>(); 
} 


} 





在 创建 好 Unity 容 器 后 ， 你 需要 告诉 该 容 右 应 用 程序 生命 周期 内 每 个 接口 对 应 的 具体 实现 类 
是 什么 。Unity 遇 到 任何 接口 时 ， 它 都 会 知道 需要 去 解析 哪个 实现 。 如 果 你 没有 为 某 个 接口 指定 
对 应 的 实现 类 ，Unity 会 提醒 你 该 接口 无 法 实例 化 。 

在 完成 接口 和 对 应 实现 类 的 关系 注册 后 ,你 需要 获得 一 个 应 用 程序 的 解析 跟 ， 也 就 是 
TaskListyiew 类 的 实例 。Unity 容 器 的 Reso1ve 方 法 会 检查 TaskListView 类 的 构造 函数 ， 然 后 学 
试 去 实例 化 构造 函数 要 注入 的 依赖 项 ， 如 此 反复 ， 直 到 完全 实例 化 整个 依赖 链 上 的 所 有 依赖 项 的 
实例 后 ，Resolve 方 法 会 成 功 实例 化 TaskListView 类 的 实例 。 这 和 穷人 的 依赖 注入 方式 的 手动 构 
造 过程 完 全 一 样 ， 不 同 的 只 是 后 者 需要 你 去 手动 检查 构造 逊 数 并 直接 实例 化 你 看 到 的 依赖 项 类 。 

1. 注册 、 解 析 、 释 放 模 式 

所 有 的 控制 反 转 容 絮 都 符合 一 个 只 有 三 个 方法 的 简单 接口 ， 如 代码 清单 9-8 所 示 。Unity 也 不 
例外 ， 它 遵守 一 个 类 似 的 模式 。 


代码 清单 9-8 尽管 每 个 控制 反 转 容 融 的 实现 不 完全 相同 ， 但 是 都 符合 下 面 这 个 通用 的 接口 


public interface IContainer : IDisposable 





























{ 
void Register<TInterface, TImplementation>() 
where TImplementation : TInterface; 
TImplementation Resol1ve<TInterface>() ; 
void Release() ; 
} 


这 三 个 方法 的 目的 解释 如 下 所 示 。 

口 Register: 应 用 程序 初始 化 会 首先 调用 该 方法 。 而 且 该 方法 会 被 多 次 调用 以 注册 很 多 不 
同 的 接口 及 其 实现 之 间 的 映射 关系 ,这 里 的 where 子 句 用 来 强制 TImplementation 类 型 必 
须 实现 它 所 继承 的 TInterface 接 口 。 该 方法 还 支持 注册 某 个 已 经 构造 好 的 实例 和 一 个 没 
有 指定 接口 的 类 型 的 映射 关系 ， 这 样 做 ， 可 以 注册 该 类 型 和 这 个 实例 所 实现 的 所 有 接口 
之 间 的 映射 关系 。 

口 Resolve: 应 用 程序 运行 时 会 调用 该 方法 。 通 常 一 组 特殊 的 类 会 被 自动 解析 为 对 象 图 中 的 
顶层 对 象 。 比 如 ， 使 用 模型 -视图 -控制 器 (MVC ) 模式 的 ASPNET 应 用 程序 中 的 控制 器 
对 象 ， 使 用 视图 模型 优先 模式 的 WPF 应 用 程序 中 的 视图 模型 对 象 ， 以 及 使 用 模型 -视图 - 
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表示 天 (MVP ) 的 Windows Form 应 用 程序 中 的 视图 对 象 。 也 就 是 说 ， 你 不 应 该 在 你 的 应 
用 程序 类 中 对 这 些 顶 层 对 象 ( 控制 右 、 视 图 、 表 示 右 、 服 务 、 域 、 业 务 逻 辑 或 数据 访问 
等 ) 调用 Resolve 方 法 。 
口 Release: 应 用 程序 生命 周期 中 ， 这 些 类 的 实例 不 再 需要 时 ， 就 可 以 释放 它们 占有 的 资源 
了 。 这 很 有 可 能 发 生 在 应 用 程序 结束 时 ,但 也 有 可 能 发 生 在 应 用 程序 运行 时 的 某 些 恰当 时 
机 。 比 如 ， 在 网 络 应 用 场景 中 ， 通 常情 况 下 ， 资 源 只 对 单 次 请 求 ( per-request ) 有 效 。 
此 , 每 次 请 求 后 都 会 调用 Release 方 法 。 有 关 对 象 生命 周期 的 问题 会 在 后 面 更 详细 地 讨论 。 
口 Dispose: 如 上 面 示例 代码 中 所 示 ， 大 多 数控 制 反 转 容器 也 都 会 实现 IDisposab1e 接 口 。 
应 用 程序 在 关闭 的 时 候 会 调用 该 方法 。Dispose 方 法 和 Release 方 法 不 一 样 ， 它 会 清除 容 
器 内 部 的 字典 ， 这 样 它 不 再 带 有 映射 关系 的 注册 信息 ， 所 以 也 就 无 法 解析 任何 依赖 了 。 
可 以 对 清单 9-7 展 示 的 第 一 个 控制 反 转 容器 示例 进行 重 构 ， 重 构 后 ， 所 有 对 容器 的 调用 都 被 
封装 在 一 个 类 内 。 这 样 做 就 可 以 把 见长 的 注册 代码 从 WPF 应 用 程序 的 后 置 代码 中 隔离 开 。 如 代码 
清单 9-9 所 示 。 


代码 清单 9-9 ”启动 事件 处 理 带 委托 配置 类 来 完成 容 希 相关 的 工作 


public partial class App : Application 
{ 


private TocConfiguration ioc; 




















private void OnApplicationStartup(object sender, StartupEventArgs e) 
{ 
CreateMappings() ; 


ioc = new IocConfiguration() ; 
ioc.Register() ; 


MainWindow = 1oc.ResolveC) ; 
MainwWindow.Show() ; 


((TaskListController)MainWindow.DataContext) .OnLoad(); 
} 


private void OnApplicationExit(object sender, ExitEventArgs e) 
{ 
ioc.Release(); 


} 


private void CreateMappings() 
{ 
AutoMapper .Mapper.CreateMap<TaskDto, TaskViewModel1>(); 
} 
} 


示例 中 的 程序 入 口 代码 现在 变 得 更 简单 了 , 所 有 控制 反 转 容 需 注册 动作 都 封装 在 一 个 专门 的 
类 中 。 代 码 清 单 9-10 展 示 了 任务 列表 应 用 程序 中 使 用 的 IocConfiguration 类 。 当 程序 退出 时 ， 
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你 可 以 在 相应 事件 的 处 理 需 方法 中 调用 该 类 的 Release 方 法 。 
代码 清单 9-10 ”下面 的 配置 类 具有 和 针对 注册 、 解 析 和 释放 模式 的 全 部 三 个 阶段 的 方法 


public class IocConfiguration 


{ 


private readonly IUnityContainer container.; 
public IocConfiguration() 


{ 
container = new UnityContainer() ; 

} 

public void Register() 

{ 
container.RegisterType<ISettings, ApplicationSettings>Q); 
container.RegisterType<IObjectMapper, MapperAutoMapper>Q; 
container.RegisterType<ITaskService, TaskServiceAdo>QO; 
container.RegisterType<TaskListController>QO; 
container.RegisterType<TaskListView>(); 

} 

public Window ResolveQ) 

{ 
return container.Resolve<TaskListView>QO; 

} 

public void Release() 

{ 
Container.Dispose() ; 

} 


} 


示例 中 的 Register 方 法 和 重 构 前 应 用 程序 入 口 的 代码 一 样 。 但 是 ， 随 着 注册 需求 的 增长 ， 与 
在 入 口 代码 中 直接 和 容器 实例 交互 相 比 ,将 代码 重 构 为 多 个 方法 能 够 让 代码 结构 和 意图 更 加 清晰 。 

Reso1ve 方 法 会 返回 一 个 通用 的 Window 类 对 象 ,而 Window 类 对 象 是 WPF 应 用 程序 的 公共 解析 
根 。 在 这 里 ， 返 回 的 是 TaskListView 类 实例 ， 因 为 它 是 这 个 程序 的 主 窗口 。 在 诸如 ASPNET 等 
其 他 应 用 程序 类 型 中 ， 通 常会 有 多 个 解析 根 ， 每 个 控制 器 都 有 一 个 。MVC 和 其 他 模式 应 用 程序 
的 组 合 根 会 在 本 章 后 面 详细 讨论 。 

2. 命令 式 与 声明 式 注册 

到 此 为 止 , 所 有 的 注册 代码 都 是 命令 式 地 从 一 个 容器 对 象 上 调用 方法 。 命 令 式 注册 方式 的 优 
势 有 : 易 读 ， 比 较 简洁 ， 编 译 时 检查 问题 的 代价 非常 小 ( 比如 防止 代码 输入 错误 等 )。 它 的 劣势 
是 : 注册 过 程 的 实现 在 编译 时 就 已 经 固定 了 。 如 果 你 想 蔡 换 现 有 实现 ,就 必须 要 直接 修改 源 代码 
并 重新 编译 。 

如 果 通 过 XML 配置 进行 声明 式 注 册 ， 你 就 不 再 需要 重新 编译 ， 只 需要 应 用 程序 重新 加 载 更 
新 的 配置 即 可 。 代 码 清单 9-11 展 示 了 Unity 的 XML 注册 方式 。 
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代码 清单 9-11 “应 用 程序 配置 文件 中 的 某 个 节 可 以 描述 接口 应 该 如 何 映射 到 实现 


<configuration> 
<configSections> 
<section name="unity" 
type="Microsoft.Practices.Unity.Configuration.UnityConfigurationSection, 
Microsoft.Practices.Unity.Configuration” /> 
</configSections> 
<appSettings> 
<add key="TaskDatabaseConnectionString”" value="Data Source=(local);Initial 
Catalog=TaskDatabase;Integrated Security=True;Application Name=Task List Editor” /> 
</appSettings> 
<unity xmlns="http://schemas.microsoft.com/practices/2010/unity"> 
<typeAliases> 
<typeAlias alias="ISettings” type="ServiceInterfaces.ISettings, ServiceInterfaces" 
/> 
<typeAlias alias="ApplicationSettings”" type="UI.ApplicationSettings, UI" /> 
<typeAlias alias="IObjectMapper”type="9ServiceInterfaces.IObjectMapper， 
ServiceInterfaces” /> 
<typeAlias alias="MapperAutoMapper”type="UI.MapperAutoMapper，UI”/> 
<typeAlias alias="ITaskService” type="ServiceInterfaces.ITaskService, 
ServiceInterfaces” /> 
<typeAlias alias="Task9erviceAdo"” type="ServiceImplementations.TaskServiceAdo, 
ServiceImplementations” /> 
<typeAlias alias="TaskListController”" type="Controllers.TaskListController, 
Controllers" /> 
<typeAlias alias="TaskListView”" type="UI.TaskListView, UI" /> 
</typeAliases> 
<container> 
<register type="ISettings" mapTo="ApplicationSettings” /> 
<register type="IObjectMapper”" mapTo="MapperAutoMapper™ /> 
<register type="ITaskService”" mapTo="TaskServiceAdo" /> 
</container> 
</unity> 
<Startup> 
<supportedRuntime version="v4.0” sku=" .NETFramework,Version=v4.5”/> 
</startup> 
</configuration> 








示例 XML 展示 了 WPF 任 务 列表 应 用 程序 的 配置 文件 内 容 。 为 Unity 增 加 的 配置 节 包 括 
typeA1ias 和 container 元 素 。 前 者 用 于 为 长 的 类 型 名 称 指定 简短 的 别名 ， 完 整 的 类 型 名 称 需要 
包括 程序 集 限定 信息 ， 这 样 Unity 在 运行 时 才 可 以 找到 指定 的 类 型 名 。 指 定 类 型 的 别名 后 ， 
container 元 素 内 会 执行 与 Register 方 法 一 样 的 动作 : 建立 接口 和 相应 实现 之 间 的 映射 关系 。 

为 了 使 用 XML 配置 文件 , 应 用 程序 的 人口 代码 也 需要 做 些 改动 。 代 码 清 单 9-12 中 高 亮 展示 了 
这 些 不 大 的 更 改 。 


代码 清单 9-12 ”现在 注册 阶段 要 做 的 只 是 把 配置 文件 中 的 相关 传递 给 容 希 对 象 


public partial class App : Application 
{ 








private IUnityContainer container; 
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private void OnApplicationStartup(object sender, StartupEventArgs e) 
{ 
CreateMappings(); 


var section = (UnityConfigurationSection)ConfigurationManager.GetSection("unity"); 
container = new UnityContainer() .LoadConfiguration(section); 


MainWindow = container.Resolve<TaskListView>(); 
MainwWindow.Show() ; 


(CTaskListController)MainWindow.DataContext) .OnLoad() ; 


} 
private void CreateMappings() 
{ 
AutoMapper .Mapper.CreateMap<TaskDto, TaskViewModel1>(); 
} 


} 





示例 中 的 改动 只 有 两 行 。 首先 你 要 使 用 ConfigurationManager 类 从 配置 文件 加 载 unity 节 数 
据 。 节 数据 会 被 转换 为 UnityConfigurationSection 类 的 实例 ， 这 样 就 可 以 把 它 传递 给 新 的 
UnityContainer 类 实例 的 LoadConfiguration 方 法 。 完 成 这 些 后 ， 就 可 以 像 前 面 一 样 ， 使 用 容 
咒 来 解析 应 用 程序 的 主 窗口 了 。 

尽管 声明 式 的 注册 能 将 接口 和 相应 实现 的 映射 动作 推迟 到 配置 时 ， 但 它 也 有 一 些 明 显 的 缺 
陷 , 在 很 多 情况 下 也 不 适合 使 用 。 它 的 最 大 缺陷 就 是 太 索 琐 。 当 前 示例 已 经 很 小 了 , 但 是 依然 有 
那么 多 类 型 需要 定义 别名 和 映射 。 某 些 情 况 下 ， 需 要 注册 的 类 型 数目 会 是 示例 代码 的 好 几 倍 ， 甚 
至 更 多 ， 相 应 的 XML 配置 文件 也 会 变 得 非常 大 。XML 文 件 中 的 别名 定义 和 关系 映射 节 中 的 输入 
错误 直到 运行 时 才能 被 发 现 和 捕获 ， 而 命令 式 地 注册 代码 能 在 编译 时 就 检查 到 对 应 的 问题 。 

声明 式 的 注册 不 够 好 的 另外 一 个 显著 原因 是 大 多 数控 制 反 转 容器 都 提供 了 很 丰富 的 注册 方 
式 。 比 如 lambda 工 厂 ， 它 会 在 解析 接口 时 调用 注册 时 提供 的 lambda 方 法 。 而 这 些 高 级 的 注册 方式 
在 声明 式 的 XML 配置 文件 中 是 无 法 做 到 的 。 

3. 对 象 的 生命 周期 

要 知道 应 用 程序 中 不 是 所 有 对 象 的 生命 周期 都 是 一 样 的 , 这 一 点 很 重要 。 也 就 是 说 ， 某 些 对 
象 可 能 会 比 其 他 对 象 有 更 长 的 生命 周期 。 当 然 ， 在 .NET 托 管 语言 的 上 下 文中 ， 没 有 能 直接 销毁 
对 象 的 方法 , 但 是 如 果 对 象 实现 了 IDispose 接 口 , 你 就 可 以 通过 调用 该 接口 的 Dispose 方 法 来 释 
放 该 对 象 占有 的 相关 资源 。 

比如 ， 代 码 清单 9-3 展 示 的 TaskService 类 中 手动 创建 了 一 个 Sql1Connection 实 例 ， 这 是 一 
个 需要 处 理 的 代码 味道 。 因为 Sq1Connection 实 例 和 TaskService 实 例 的 生命 周期 并 不 一 致 , 后 
者 的 生命 周期 从 应 用 程序 启动 时 开始 ， 一 直到 应 用 程序 退出 。 如 代码 清单 9-13 所 示 ， 如 果 把 
Sql1Connection 注 入 到 TaskService 后 ， 它 会 在 应 用 程序 运行 时 一 直 存 在 。 然 而 ,这 并 不 意味 着 
连接 在 此 期 间 就 一 直 打 开 着 ， 因 为 打开 连接 是 另外 一 个 独立 的 操作 。 
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代码 清单 9-13 有些 资源 的 生命 周期 需要 巡 慎 管理 


private void OnApplicationStartup(object sender, StartupEventArgs e) 
{ 
CreateMappingsQO; 


container = new UnityContainer(); 
container.RegisterType<ISettings, ApplicationSettings>QO; 
container.RegisterType<IObjectMapper, MapperAutoMapper>(); 
container.RegisterType<ITaskService, TaskServiceAdo>(new InjectionFactory(c => new 
TaskServiceAdo(new 
SqlConnection(c.Resolve<ISettings>() .GetSetting("TaskDatabaseConnectionString"))))); 
Container.RegisterType<TaskListController>() ; 
Container.RegisterType<TaskListView>(D) ; 


MainWindow = container.Resolve<TaskListView>() ; 
MainWindow.Show(); 


((TaskListController)MainWindow.DataContext) .OnLoad() ; 
} 
024 
public class TaskServiceAdo : ITaskService 


{ 


private readonly IDbConnection connection ; 
public TaskServiceAdo(IDbConnection connection) 
{ 


this.connection = connection; 


public IEnumerable<TaskDto> GetAllTasks() 
{ 


var allTasks = new List<TaskDto>() ; 


using (connection) 
{ 


connection.0pen() ; 


using (var transaction = connection.BeginTransaction()) 
{ 
var command = connection.CreateCommand(); 
command.Transaction = transaction; 
command.CommandType = CommandType.StoredProcedure; 
command.CommandText = "[dbol].[get all_tasks]"; 


using (var reader = 
command.ExecuteReader(CommandBehavior.CloseConnection)) 
{ 
while (reader.Read()) 
{ 
allTasks .Add( 
new TaskDto 
{ 
ID = reader.GetInt32(IDIndex), 
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Description = reader.GetString(DescriptionIndex), 
Priority = reader.GetString(PriorityIndex), 
DueDate = reader.GetDateTime (DueDateIndex), 
Completed = reader.GetBoolean(CompletedIndex) 


} 


return allTasks; 





示例 中 应 用 程序 入 口 代 码 处 的 第 一 个 改动 是 使 用 了 一 个 注入 工厂 来 创建 任务 服务 。 这 个 
lambda 表 达 式 通过 容器 解析 参数 后 返回 了 一 个 新 的 服务 实例 。 原 来 对 ISetting 接 口 的 
GetSettings 方 法 的 调用 也 移 到 了 lambda 表 达 式 内 , 用 来 获得 连接 字符 串 。 这 个 字符 串 会 传递 给 
SqlConnection 类 的 构造 函数 ， 而 创建 好 的 Sq1Connection 实 例 则 会 传递 给 TaskServiceAdo 类 
的 构造 也 数 。 

GetA1l1Tasks 方 法 中 的 using (connection) 语 句 是 有 问题 的 。using 语 句 结 束 前 会 确保 调用 
SqlConnection 类 的 Dispose 方 法 。 这 样 , 在 调用 GetA11Tasks 方 法 后 , 连接 就 已 经 变 得 无 效 了 ， 
因为 它 占 有 的 资源 已 经 被 释放 了 。 想 要 使 用 连接 ， 你 能 做 的 只 能 是 再 次 调用 GetA11Tasks 方 法 。 

假设 TaskServcieAdo 类 也 实现 了 IDisposable 接 口 ， 那 么 在 它 的 Dispose 方 法 中 再 去 调用 
连接 实例 的 Dispose 方 法 会 如 何 ” 代 码 清单 9-14 展 示 了 这 种 方式 。 


代码 清单 9-14 服务 实现 了 IDisposable 接 口 ， 因 为 它 可 以 去 释放 连接 的 资源 


public class TaskServiceAdo : ITaskService, IDisposable 











{ 
public TaskServiceAdo(IDbConnection connection) 
{ 
this.connection = connection; 
} 


public IEnumerable<TaskDto> GetAllTasks©Q 
{ 


var allTasks = new List<TaskDto>() ; 
connection.OpenQO; 


try 
{ 
using (var transaction = connection.BeginTransactionQO) 
{ 
var command = connection.CreateCommand(); 
command .Transaction transaction; 
command .CommandType = CommandType.StoredProcedure 





262 第 9 章 依赖 注入 原则 


command .CommandText = "[dbol].[get all_tasks]"; 


using (var reader = 
command.ExecuteReader(CommandBehavior.CloseConnection)) 


{ 
while (reader.Read(O)) 
allTasks .Add( 
new TaskDto 
{ 
ID = reader.GetInt32(IDIndex), 
Description = reader.GetString(DescriptionIndex), 
Priority = reader.GetString(PriorityIndex), 
DueDate = reader.GetDateTime (DueDateIndex), 
Completed = reader.GetBoolean(CompletedIndex) 
} 
): 
} 
} 
} 
} 
finally 
{ 
connection.Close(); 
} 
return allTasks; 
} 
public void Dispose(Q) 
{ 
connection.Dispose(); 
} 





上 面 的 示例 并 不 是 在 GetA11Tasks 方 法 中 释放 连接 ,而 是 在 释放 服务 本 号 时 才 释 放 它 。 这 就 
牵扯 到 何 时 释放 任务 服务 这 个 重要 的 问题 。 需 要 在 构造 吨 数 注入 ITaskServi ce 接口 实例 的 所 有 
客户 端 类 型 也 都 要 实现 IDisposab1e 接 口 吗 ? 谁 来 释放 这 些 对 象 ?” 最 终 , 你 总 是 需要 在 某 些 地 方 
调用 Dispose 方 法 。 

如 果 一 个 类 通过 构造 函数 得 到 了 一 个 依赖 项 , 它 就 不 应 该 手动 释放 该 依赖 项 的 资源 。 这 一 点 
非常 重要 。 因 为 该 类 无 法 确保 该 依赖 项 实例 是 否 也 同时 提供 给 了 其 他 类 , 因此 手动 释放 它 的 资源 
会 很 可 能 会 影响 其 他 使 用 这 个 依赖 的 类 。 

使 用 依赖 注入 时 管理 对 象 生 命 周期 问题 的 方式 和 原始 服务 实现 的 方式 很 接近 。 

@ 连接 工厂 

工厂 模式 就 是 一 种 通过 委托 一 个 专门 用 来 创建 对 象 的 类 来 替代 手动 实例 化 对 象 过 程 的 方式 。 

代码 清单 9-15 展 示 了 可 能 的 连接 工厂 接口 定义 ,这 个 接口 中 的 CreateConnection 方 法 返回 
的 是 更 加 通用 的 IDbConnection 接 口 实例 , 而 不 是 要 求 所 有 客户 端 都 要 使 用 的 Sq1Connection 类 。 
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代码 清单 9-15 ”连接 工厂 接口 看 起 来 很 简单 
public interface IConnectionFactory 


{ 


IDbConnection CreateConnection(); 


} 





可 以 把 这 个 接口 的 实例 注入 到 任务 服务 中 , 然后 通过 它 来 获取 连接 ， 而 不 再 需要 手动 创建 连 
接 ， 这 样 也 保持 了 模拟 该 任务 服务 实现 的 可 测 性 。 代 码 清单 9-16 展 示 了 重 构 后 的 服务 。 


代码 清单 9-16 依赖 注入 可 以 与 工厂 模式 协同 工作 


public class TaskServiceAdo : ITaskService 


{ 


private readonly IConnectionFactory connectionFactory; 


public TaskServiceAdo(IConnectionFactory connectionFactory) 


{ 


this.connectionFactory = connectionFactory; 


} 


public IEnumerable<TaskDto> GetAllTasks©Q 
{ 


var allTasks = new List<TaskDto>() ; 


using(var connection = connectionFactory.CreateConnection()) 


{ 


connection.OpenQO; 


using (var transaction = connection.BeginTransaction()) 
{ 
var command = connection.CreateCommand(); 
command.Transaction = transaction; 
command.CommandType = CommandType.StoredProcedure; 
command.CommandText = "[dbol].[get all_tasks]"; 


using (var reader = 
command.ExecuteReader (CommandBehavior.CloseConnection)) 





{ 
while (reader.Read(O)) 
{ 
allTasks .Add( 
new TaskDto 
{ 
ID = reader.GetInt32(IDIndex), 
Description = reader.GetString(DescriptionIndex), 
Priority = reader.GetString(PriorityIndex), 
DueDate = reader.GetDateTime (DueDateIndex), 
Completed = reader.GetBoolean(CompletedIndex) 
} 
3 
} 
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} 


return allTasks; 


注意 ，CreateConnection 方 法 返回 的 连接 实例 会 在 using 语 句 块 结束 时 被 释放 ， 因 为 工厂 
生成 的 IDbConnection 接 口 实例 都 实现 了 IDisposable 接 口 。 通 过 接口 继承 , 可 以 让 单个 实现 类 
同时 满足 多 个 接口 的 定义 。 

然而 , 是 否 每 个 实现 一 定 需要 实现 每 个 接口 ? 有 时 候 是 的 , 但 是 考虑 到 一 个 接口 会 有 很 多 种 
实现 ， 尤 其 是 在 原始 版 本 后 过 了 很 长 时 间 ， 这 需要 做 一 个 大 胆 的 假定 。 但 是 对 于 IDisposable 
接口 而 言 ， 很 难保 证 每 个 类 都 实现 了 它 。 

@ 负责 人 模式 

你 可 以 只 在 真正 需要 释放 的 类 上 实现 IDisposable 接 口 ， 而 不 是 劳 心 费力 地 要 求 所 有 实现 
都 实现 它 。 但 是 这 也 会 产生 一 个 问题 。 如 果 工 厂 方法 返回 的 结果 ( 也 就 是 你 的 接口 实例 ) 并 没 
有 实现 IDisposab1e 接 口 , 你 就 无 法 使 用 using 语 句 块 来 释放 它 。 这 种 情况 下 , 你 必须 使 用 负责 
人 模式 。 

代码 清单 9-17 中 使 用 try/final1y 语 句 块 代替 了 using 语 句 块 ， 同 时 ， 你 可 以 在 运行 时 检查 
实例 对 象 是 否 实现 了 IDisposable 接 口 。 


代码 清单 9-17 负责 人 模式 可 以 确保 正确 地 释放 对 象 占 有 的 资源 


public IEnumerable<TaskDto> GetAllTasks(Q) 
{ 





























var allTasks = new List<TaskDto>() ; 


var connection = connectionFactory.CreateConnectionQ); 
try 
{ 


connection.0pen() ; 


using (var transaction = connection.BeginTransaction()) 
{ 
var command = connection.CreateCommand(); 
command.Transaction = transaction; 
command.CommandType = CommandType.StoredProcedure; 
command.CommandText = "[dbo].[get all_tasks]"; 


using (var reader = command.ExecuteReader(CommandBehavior.CloseConnection)) 
{ 
while (reader.Read()) 
{ 
allTasks.Add( 
new TaskDto 
{ 
ID = reader.GetInt32(IDIndex), 
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Description = reader.GetString(DescriptionIndex), 
Priority = reader.GetString(PriorityIndex), 
DueDate = reader.CGetDateTime(DueDateIndex), 
Completed = reader.GetBoolean(CompletedIndex) 


} 
)3 
} 
} 
} 
} 
finally 
{ 
if(connection is IDisposable) 
{ 
var disposableConnection = connection as IDisposable; 
disposableConnection.DisposeQ); 
} 
} 


return allTasks; 


} 


示例 中 ， 只 有 实现 了 IDisposab1e 接 口 的 连接 实例 才 会 调用 Dispose 方 法 。 无 论 工 厂 方法 返 
回 的 结果 是 否 实现 了 IDisposable ，GetAllTasks 方 法 都 可 以 正常 工作 。 对 于 实现 了 
IDisposable 接 口 的 实例 ， 它 所 占有 的 资源 就 会 被 正确 释放 。 

负责 人 模式 会 明确 地 释放 实现 了 IDisposable 接 口 的 实例 对 象 , 从 而 有 效 地 忽略 那些 没有 实 
现 IDisposable 接 口 的 对 象 ,但 是 ，SOLID 代 码 通 常会 有 很 多 修饰 右 存 在 ,它们 会 未 层 包 装 以 提 
供 额外 的 功能 。 这 种 情况 下 ， 如 果 顶 层 对 象 实现 『IDisposable 接 口 , 负责 人 模式 是 可 以 正常 工 
作 的 。 但 是 如 果 外 部 修饰 器 对 象 没有 实现 IDisposab1e 接 口 , 而 内 层 对 象 实现 了 IDisposable 时 ， 
负责 人 模式 就 没有 办 法 正确 释放 这 些 内 层 的 实例 了 。 此 时 ， 你 必须 应 用 工 广 隔离 模式 。 

e@ 工厂 隔离 模式 

这 种 模式 能 够 明确 地 释放 整个 复杂 的 对 象 图 , 而 SOLID 代 码 通常 会 形成 这 样 的 对 象 图 。 这 个 
模式 的 名 称 来 源 于 图 书馆 常用 的 带 手 套 的 箱子 。 这 些 玻璃 或 金属 的 箱子 会 目 带 手套 以 确保 人 们 对 
箱 内 内 容 的 操作 是 安全 的 。 类 似 地 ,工厂 隔离 模式 能 够 保证 安全 访问 对 象 的 实例 ,而 且 这 些 实例 
会 在 使 用 后 被 正确 地 释放 。 

只 有 在 接口 没有 实现 IDisposable 时 才 需 要 应 用 工厂 隔离 模式 。 要 求 所 有 类 都 实现 
IDisposable 接 口 的 Dispose 方 法 是 不 现实 的 ， 也 是 不 必要 的 。 相 反 ，IDisposable 应 该 被 看 作 
实现 细节 并 由 各 个 类 自己 做 主 是否 实 现 它 。 这 就 是 负责 人 模式 和 工厂 隔离 模式 的 应 用 场景 。 

前 面 的 示例 都 在 围绕 着 IDbConnection 接 口 实例 的 生命 周期 进行 讲解 ,但 该 接口 实际 上 已 经 
继承 了 IDisposable 接 口 。 那 么 ， 如 果 我 们 假设 这 个 接口 并 没有 扩展 继承 IDisposable 接 口 ， 从 
客户 端 代码 角度 看 到 的 工厂 隔离 模式 代码 就 会 如 代码 清单 9-18 所 示 。 
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代码 清单 9-18 一 个 使 用 工厂 隔离 模式 的 客户 端 代码 示例 


public IEnumerable<TaskDto> GetAllTasks() 


{ 
var allTasks = new List<TaskDto>() ; 
connectionFactory.With(connection => 
{ 
connection.OpenQO; 
using (var transaction = connection.BeginTransaction()) 
{ 
var command = connection.CreateCommand () ; 
command.Transaction = transaction; 
command.CommandType = CommandType.StoredProcedure 
command .CommandText =“[dbo].[get_all_tasks]”; 
using (var reader = command.ExecuteReader(CommandBehavior.CloseConnection)) 
{ 
while (reader.Read()) 
{ 
allTasks.Add( 
new TaskDto 
{ 
ID = reader.GetInt32(IDIndex), 
Description = reader.GetString(DescriptionIndex), 
Priority = reader.GetString(PriorityIndex), 
DueDate = reader.CGetDateTime (DueDateIndex), 
Completed = reader.CetBoolean(CompletedIndex) 
} 
DE 
} 
} 
} 
bE 
return allTasks; 
} 


工厂 隔离 模式 并 没有 使 用 常见 的 返回 工厂 产品 的 实例 的 Create 方 法 ， 而 是 使 用 With 方 法 ， 
该 方法 可 以 接受 一 个 以 工厂 产品 为 参数 的 lambda 方 法 。 

这 样 做 带 来 的 好 处 是 : 工厂 方法 返回 实例 的 生命 周期 会 显 式 地 由 lambda 方 法 决定 。 这 会 让 无 
法 控制 对 象 生 命 周 期 的 客户 端 代码 变 得 非常 简练 。 工 三 实 现 本 身 非常 简单 , 如 代码 清单 9-19 所 示 。 


代码 清单 9-19 ”创建 一 个 隔离 工厂 很 简单 


public class IsolationConnectionFactory : IConnectionIsolationFactory 


{ 





public void With(Action<IDbConnection> do) 
{ 
using(var connection = CreateConnection(D)) 
{ 
do(connection); 


} 
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} 
} 





其 中 的 with 方 法 能 够 创建 带 有 大 量 修饰 各 、 适 配 帮 和 组 合 ( 也 是 SOLID 建 议 的 ) 的 复杂 对 象 
图 ， 而 且 可 以 管理 这 些 对 象 的 生命 周期 ， 客户 端 代码 无 需 操 心 任何 资源 释放 事宜 ,只 需要 简单 地 
使 用 这 些 对 象 即 可 。 

注意 ,如 果 把 lambda 方 法 范围 内 的 实例 对 象 赋值 给 一 个 有 更 长 生命 周期 的 变量 , 那么 工厂 隔 
离 模式 就 会 失效 ， 所 以 并 不 鼓励 在 客户 端 代码 中 做 这 样 的 赋值 。 


9.2 比较 复杂 的 注入 


通过 使 用 各 种 不 同 的 框架 ,依赖 注入 的 实现 方式 也 可 以 有 很 多 种 。 有 些 模式 有 着 积极 的 作用 ， 
它们 能 够 在 确保 完成 目标 的 同时 支持 和 增强 依赖 注入 的 能 力 。 其 他 一 些 模式 则 相反 ,它们 会 背离 
依赖 注入 的 根本 目的 并 且 会 削弱 依赖 注入 的 能 

有 两 个 这 样 的 模式 特别 值得 注意 。 第 一 个 是 服务 定位 器 反 模式 ,不 地 的 是 ， 它 也 很 常见 。 它 
在 很 多 框架 和 库 中 都 有 应 用 ,有 了 时候,， 它 也 是 唯一 能 提供 依赖 注入 钧 子 的 方式 。 比 服务 定位 絮 更 
糟糕 的 一 个 反 模式 是 非法 注入 (Illegitimate Injection )， 它 的 名 称 并 没有 充分 表明 它 的 副作用 。 它 
有 时 会 使 用 依赖 注入 的 灰色 地 这 ,能够 在 不 恰当 地 提供 依赖 的 情况 下 构建 服务 、 控 制 锅 和 其 他 一 
些 类 似 的 实体 对 象 。 

当 你 在 使 用 依赖 注入 时 , 不 同类 型 的 应 用 程序 会 需要 不 同 的 设置 。 不论 是 哪 种 类 型 的 应 用 程 
序 ， 你 都 需要 识别 组 合 根 以 便 在 正确 的 地 方 集成 你 的 注册 代码 。WPF 应 用 程序 和 Windows Form 
应 用 程序 的 组 合 根 是 不 同 的 ， 而 二 者 也 都 与 ASPNET MVC 应 用 程序 的 组 合 根 不 同 。 

在 一 些 高 级 场景 中 ， 无 论 是 通过 穷人 的 依赖 注入 手动 组 合 类 型 ， 还 是 使 用 一 个 控制 反 转 容 
锅 的 单个 注册 类 型 ， 这 两 种 方式 都 太 演 琐 上 且 费 时 费力 。 通 过 一 个 或 多 个 约定 推迟 注册 的 过 程 ， 
你 能 够 消除 很 多 没 用 的 样板 代码 ， 但 同时 也 能 提供 一 些 手动 的 注册 来 处 理 那 些 不 满足 约定 的 边 
界 情况 。 


9.2.1 服务 定位 器 反 模 式 


服务 定位 旭 看 起 来 与 控制 反 转 容 右 很 相似 , 这 也 正 是 它们 经 常 不 会 被 怀疑 给 代码 造成 破坏 的 
原因 。 代 码 清单 9-20 展 示 了 Microsoft 的 模式 和 实践 团队 提供 的 一 个 服务 定位 锅 的 示例 。 


代码 清单 9-20 IServiceLocater 接 口 看 起 来 就 像 是 另外 一 种 形式 的 控制 反 转 容 髓 


public interface IServicelLocator : IServiceProvider 


{ 
object GetInstance(Type serviceType) ; 









































object GetInstance(Type serviceType，string key); 


IEnumerable<object> GetAllInstances(Type serviceType); 
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TService GetInstance<TService>O; 
TService GetInstance<TService>(string key); 


IEnumerable<TService> GetAllInstances<TService>QO; 


其 中 诸如 TService GetInstance<TService>( 之 类 的 方法 能 够 与 TUnityContainer 接 口 
中 的 定义 直接 对 应 起 来 , 只 是 后 者 使 用 的 方法 名 为 Resolve。 问题 出 在 服务 定位 右 的 使 用 方式 上 ， 
代码 清单 9-21 展 示 的 静态 ServiceLocator 类 暴露 了 这 个 问题 。 


代码 清单 9-21 这 个 静态 类 就 是 将 服务 定位 需 归 类 为 反 模式 的 根本 原因 


/// <summary> 

/// This class provides the ambient container for this application. If your 
/// framework defines such an ambient container, use ServiceLocator.Current 
/// to get it. 

/// </summary> 

public static class ServiceLocator 











{ 
private static ServiceLocatorProvider currentProvider; 
public static IServicelLocator Current 
{ 
get { return currentProviderO; } 
} 
public static void SetLocatorProvider(ServiceLocatorProvider newProvider) 
{ 
currentProvider = newProvider ; 
} 
} 


我 在 示例 中 保留 的 摘要 注释 直接 点 出 了 问题 所 在 。 环 境 容 器 (ambient container ) 的 概念 
经 透露 了 有 一 个 容 需 存在 的 细节 信息 。 尽管 把 具体 的 服务 定位 器 实现 总 藏 在 接口 之 后 是 正确 的 ， 
但 是 问题 在 于 它 在 任意 类 型 内 而 不 只 是 在 组 合 根 内 骏 露 了 服务 定位 咒 或 者 容 费 存在 的 信息 。 代码 
清单 9-22 显 示 了 重 写 TaskListController 以 使 用 ServiceLocator 时 TaskListController 的 
样子 。 
代码 清单 9-22 ”服务 定位 器 允许 类 检索 任何 内 容 ， 无 论 是 否 适 合 


public class TaskListController : INotifyPropertyChanged 
{ 











public void OnLoad () 

{ 
var taskService = ServiceLocator.Current.GetInstance<ITaskService>(); 
var taskDtos = taskService.GetAllTasks(Q); 
var mapper = 9S9erviceLocator.Current.GetInstance<IObjectMapper> (D) ; 
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AllTasks = new 
ObservableCollection<TaskViewModel1l>(mapper.Map<IEnumerable<TaskViewMode1>>(taskDtos)); 


} 
public ObservableCollection<TaskViewModel> AllTasks 
{ 
get 
{ 
return allTasks; 
set 
{ 
allTasks = value; 
PropertyChanged(this, new PropertyChangedEventArgs("AllTasks")); 
} 
} 


public event PropertyChangedEventHandler PropertyChanged = delegate { }; 


private ObservableCollection<TaskViewModel> allTasks; 


} 


这 个 示例 没有 构造 函数 ， 当 然 也 就 没有 构造 函数 注入 。 相 反 , 该 类 在 需要 的 地 方 直接 调用 静 
态 的 ServiceLocator 类 并 返回 请 求 的 服务 。 记 住 ， 像 这 样 的 静态 类 都 是 天 钧 (skyhook )， 它 是 
一 种 代码 味道 。 

更 糟糕 的 是 , 该 类 能 从 服务 定位 硕 检 索 任 意 对 象 . 这 样 你 就 违背 了 依赖 注入 的 “好莱坞 准则 ”: 
不 要 调用 我 们 , 我 们 会 调用 你 。 相 反 ,， 你 是 在 直接 要 求 需要 的 东西 ， 而 不 是 从 其 他 地 方 传递 得 来 
的 。 你 又 如 何 知 道 这 个 类 到 底 还 需要 什么 样 的 依赖 呢 ? 使 用 服务 定位 项 ,你 必须 检查 代码 以 搜索 
变化 无 常 的 调用 , 这 些 调用 会 检索 某 个 需要 的 服务 。 你 只 需要 看 一 眼 构造 郴 数 或 者 智能 感知 列 出 
的 信息 ， 就 可 以 从 构造 函数 注入 中 清楚 地 看 到 所 有 的 依赖 。 

服务 定位 器 模式 并 没有 单元 测试 的 问题 。 因 为 在 使 用 它 之 前 ， 你 可 以 设置 一 个 
IServiceLocator 接 口 的 实现 , 也 就 是 说 , 可 以 模拟 服务 定位 带 来 对 使 用 它 的 其 他 类 型 做 单元 测 
试 。 至 少 , 服务 定位 需 模 式 并 没有 阻止 你 去 做 单元 测试 。 只 是 大 量 的 注册 接口 和 相应 实现 类 映射 关 
系 的 代码 有 些 不 合理 , 因为 控制 带 、 服 务 带 和 其 他 类 的 实现 代码 会 被 这 些 基 础 代码 污染 。 在 没有 需 
要 解决 的 问题 时 应 用 这 种 服务 定位 带 模 式 会 更 加 不 合理 ， 而 构造 函数 注入 并 不 需要 担心 这 些 问题 。 

Unity 中 提供 了 一 个 服务 定位 絮 的 适 配 副 ,代码 清单 9-23 展 示 了 如 何 通 过 它 注册 设置 好 的 映射 
代码 清单 9-23 ”服务 定位 器 会 直接 委托 UnityContainer 实 例 来 解析 实例 对 象 

private void OnApplicationStartup(object sender, StartupEventArgs e) 


{ 
CreateMappings () ; 























container = new UnityContainer() ; 
container.RegisterType<ISettings, ApplicationSettings>QO; 
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container.RegisterType<IObjectMapper, MapperAutoMapper>(Q); 
container.RegisterType<ITaskService, TaskServiceAdo>(Q); 
Container.RegisterType<TaskListController>() ; 
Container.RegisterType<TaskListView>() ; 


ServicelLocator.SetLocatorProvider(() => new Unity9erviceLocatorCcontainer) ) ; 


MainWindow = container.Resolve<TaskListView>() ; 
MainWindow.Show(); 


((TaskListController)MainWindow.DataContext) .OnLoad() ; 
} 


这 与 前 面 的 示例 看 起 来 很 像 ， 只 是 没有 去 设置 定位 需 提 供 者 。 但 是 ， 对 Reso1ve 方 法 的 调用 
并 没有 真正 解析 对 象 图 ; 也 不 再 有 任何 依赖 注入 到 TaskListView 类 的 构造 函数 中 ， 所 有 的 依赖 
都 是 在 需要 时 才 在 该 类 的 方法 中 单独 获取 的 。 

服务 定位 需 模 式 是 个 很 好 的 反面 例子 , 它 表 面 声称 的 东西 并 不 符合 应 用 后 的 实际 效果 。 它 声 
称 带 有 默认 构造 函数 的 类 没有 依赖 , 但 是 显然 不 是 这 样 的 : 它们 肯定 有 依赖 ,要 不 然 你 为 何 要 从 
服务 定位 器 中 获取 它们 。 

不 笠 的 是 ， 有 时 又 必须 应 用 服务 定位 需 反 模式 。 在 某 些 应 用 程序 类 型 里 ， 特 别 是 Windows 
Workflow Foundation ， 基 础 库 根本 没有 从 构造 函数 注入 的 任何 机 会 。 在 这 些 情况 下 ， 你 的 唯一 选 
择 就 是 服务 定位 器 ， 它 至 少 比 完全 不 注入 依赖 要 好 。 虽 然 我 对 反 模 式 提 出 了 这 么 多 批判 , 但 是 它 
们 肯定 比 完 全 手动 构造 依赖 要 好 。 毕 葛 ， 它 也 能 够 使 用 接口 提供 所 有 重要 的 扩展 点 ， 也 就 是 说 ， 
可 以 获得 修饰 器 、 适 配 需 以 及 其 他 一 些 类 似 的 好 处 。 

注入 容器 

与 服务 定位 融 密 切 相 关 的 是 在 类 型 中 注入 容 需 的 概念 。 同 样 ， 这 把 类 变 成 了 安全 的 关键 点 ， 
通过 这 种 方式 将 容器 注入 到 类 之 后 , 就 可 以 自由 使 用 容 右 获取 任何 想 获取 的 实例 对 象 。 假设 有 这 
样 一 个 类 , 它 的 多 个 方法 中 零 零 散 散 地 获取 了 很 多 服务 对 象 实例 。 再 假设 另外 一 个 类 是 从 构造 疗 
数 中 注入 了 同样 多 的 依赖 对 象 , 该 类 会 在 构造 函数 入口 处 对 这 些 依 赖 对 象 做 完整 的 前 置 条 件 检 查 
并 会 在 发 现 空 引用 时 引发 异常 。 显 然 ,， 这 两 个 类 都 做 得 太 多 了 ， 如 果 需 要 那么 多 的 依赖 ， 就 应 该 
把 它们 重 构 为 规模 更 小 的 类 或 者 将 各 种 依赖 组 织 为 有 意义 的 修饰 器 。 但 是 , 相 比 较 假设 的 第 一 个 
类 ， 只 有 第 二 个 类 才能 明显 地 其 露出 这 种 代码 味道 ， 这 样 才 能 有 机 会 尽早 发 现 并 消除 它 。 

男 外 ,从 构造 函数 注入 容器 的 类 也 必须 引用 容 颖 的 程序 集 。 这 会 让 容 右 基础 代码 扩散 到 整个 
代码 库 中 ， 因 为 每 个 类 都 接受 了 注入 的 容器 以 获取 它们 真正 需要 的 服务 对 象 。 


9.2.2 ”非法 注入 


非法 注入 表面 看 起 来 很 像 正 常 的 , 就 像 正确 实现 的 依赖 注入 。 它 们 也 有 可 以 注入 依赖 的 构造 
函数 ， 也 是 通过 穷人 的 依赖 注入 或 控制 反 转 容 大 提供 依赖 对 象 。 
但 是 , 由 于 带 有 默认 构造 函数 , 这 些 对 穷人 的 依赖 注入 和 控制 反 转 容 带 的 应 用 已 经 的 的 确 确 
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被 破坏 了 。 代 码 清单 9-24 展 示 了 这 种 情况 ， 黑 认 构造 冰 数 中 直接 构造 了 一 些 依赖 的 实现 对 象 ， 因 
此 也 绕 开 了 依赖 注入 。 


代码 清单 9-24 ”构造 函数 直接 引用 实现 会 直接 让 依赖 注入 的 很 多 优势 失效 


public class TaskListController : INotifyPropertyChanged 
{ 
public event PropertyChangedEventHandler PropertyChanged = delegate { }; 


private readonly ITaskService taskService; 
private readonly IObjectMapper mapper; 


private ObservableCollection<TaskViewModel> allTasks; 


public TaskListController(ITaskService taskService, IObjectMapper mapper) 


{ 
this.taskService = taskService; 
this.mapper = mapper; 
} 
public TaskListControllerQ) 
1 
this.taskService = new TaskServiceAdo(new ApplicationSettings(); 
this.mapper = new MapperAu toMapperQO; 
} 


public void OnLoad () 
{ 
var taskDtos = taskService.GetAllTasksQO; 
AllTasks = new 
ObservableCollection<TaskViewModel1l>(mapper.Map<IEnumerable<TaskViewMode1>>(taskDtos)); 





} 
public ObservableCollection<TaskViewModel> AllTasks 
{ 
get 
{ 
return allTasks; 
set 
{ 
allTasks = value; 
PropertyChanged(this, new PropertyChangedEventArgs("AllTasks")); 
} 
} 


这 就 意味 痢 ， 该 类 必须 引用 实现 所 在 的 程序 集 ,， 并 且 同 时 引入 它 的 整个 依赖 链 。 这 不 就 是 随 
从 反 模 式 吗 ?尽管 第 一 个 构造 孙 数 是 接受 注入 的 接口 实例 , 看 起 来 很 好 地 应 用 了 阶梯 模式 和 正确 
的 依赖 注入 ,但 是 第 二 个 上 默认 构造 函数 却 直 接 破 坏 了 它们 带 来 的 好 处 。 

如 采 上 默认 实现 不 再 是 你 想 要 的 时 怎么 办 ?该 类 会 被 修改 为 更 豆 欢 的 类 。 如 果 一 个 默认 构造 
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数 不 够 用 ， 那 么 你 想 在 某 些 场景 下 实现 A， 而 在 其 他 场景 下 叉 想 实现 B 时 ， 该 怎么 办 ?构造 函数 
带 来 的 副作用 会 很 快 让 人 失去 耐心 的 。 

有 时 这 种 容器 注入 的 反 模 式 也 会 被 用 来 支持 单元 测试 。 要 模拟 测试 类 的 默认 实现 看 起 来 并 没 
有 依赖 ,它们 可 能 就 在 该 类 的 内 部 。 类 内 部 不 应 该 包含 任何 只 用 于 支持 单元 测试 的 代码 。 很 常见 
的 例子 就 是 ， 先 把 private 方 法 变 为 internal， 然后 应 用 InternalsVisibleToAttribute 属 性 
来 让 测试 程序 集 访问 这 些 方 法 ， 而 不 是 只 让 测试 类 通过 publ1ic 接 口 进行 测试 。 实 话 实 说 ， 依 赖 
注入 支持 单元 测试 的 能 力也 存在 被 奔 大 的 现象 , 但 是 这 恰好 说 明了 关键 点 所 在 : 你 已 经 通过 使 用 
接口 来 支持 单元 测试 并 将 它们 注入 到 了 构造 函数 ， 因 此 模拟 对 象 可 以 (也 应 当 ) 通过 构造 吨 数 注 
入 到 接口 的 类 实现 中 。 

非法 注入 被 归 类 为 反 模式 并 不 会 因为 默认 构造 函数 的 可 见 性 而 改变 。 无 论 默 认 构 造 子 数 是 
pub1ic、protected、private 或 者 internal ， 事 实 都 很 清楚 : 你 在 引用 它 时 不 应 该 直接 引用 
具体 的 实现 。 








9.2.3 组 合 根 


应 用 程序 中 只 应 该 有 一 个 位 置 知道 依赖 注入 的 细节 ,这 个 位 置 就 是 组 合 根 。 在 使 用 穷人 的 依 
赖 注入 时 就 是 你 手动 构造 类 的 地 方 , 在 使 用 控制 反 转 容 涟 时 驶 是 你 注册 接口 和 实现 类 间 映 射 关 系 
的 地 方 。 

理想 情况 下 ,组 合 根 和 应 用 程序 的 入口 越 近 越 好 。 这 样 能 让 你 尽快 配置 好 依赖 注入 。 组 合 根 
提供 了 一 个 查找 依赖 注入 配置 的 公认 位 置 , 它 能 帮 你 避免 把 对 容 表 的 依赖 扩散 到 应 用 程序 的 其 他 
地 方 。 这 也 意味 着 不 同 种 类 的 应 用 程序 有 着 不 同 的 组 合 根 。 

1. 解析 根 

与 组 合 根 密 切 相 关 的 一 个 概念 是 解析 根 。 它 是 要 解析 的 目标 对 象 图 中 根 节 点 的 对 象 类 型 。 在 
前 面 的 WPF 示 例 中 , 解析 根 甚 至 可 以 是 个 单 例 对 象 , 但 是 通常 情况 下 , 它们 都 是 一 组 基于 公共 基 
类 的 类 型 。 

有 些 情况 下 , 你 要 上 自己 手动 获得 解析 根 , 但 是 在 有 些 类 型 的 应 用 程序 已 经 利用 了 依赖 注入 ( 比 
如 MVC 模 式 ) 来 处 理解 析 根 时 ， 你 需要 做 的 只 是 注册 接口 和 类 的 映射 关系 。 

2. ASP.NET MVC 

MVC 模 式 的 工程 已 经 很 好 地 通过 控制 反 转 容 右 应 用 了 依赖 注入 。 这 些 工程 已 经 清楚 地 定义 
了 解析 根 和 组 合 根 ， 也 能 够 轻易 地 扩展 以 文 持 你 可 能 需要 为 控制 反 转 容 需 集成 的 任何 库 。 

MYVC 应 用 程序 的 解析 根 就 是 控制 项 。 所 有 来 自 浏 览 融 的 请 求 都 会 被 路 由 到 被 称 为 动作 
( action ) 的 控制 器 方法 上 。 每 当 请 求 到 来 时 ，MVC 框 架 会 将 URL 映 射 为 某 个 控制 器 名 称 ， 然 后 
找到 名 称 对 应 的 类 并 实例 化 它 ， 最 后 再 在 该 实例 上 触发 动作 。 图 9-4 中 的 UML 时 序 图 展示 了 这 个 
交互 的 过 程 。 
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图 9-4 UML 时 序 图 展示 了 MVC 通 过 工厂 构造 控制 器 的 过 程 


在 使 用 控制 反 转 容器 进行 依赖 注入 时 ， 更 确切 地 讲 ， 实 例 化 控制 器 的 过 程 就 是 解析 
( resolution ) 控制 锅 的 过 程 。 这 就 意味 着 ， 你 能 轻易 地 按照 注册 、 解 析 和 释放 的 模式 ， 最 小 化 对 
Resolve 方 法 的 调用 ， 理 想 情 况 下 ， 就 只 应 该 在 一 个 地 方 调用 该 方法 。 

代码 清单 9-25 展 示 了 任务 列表 应 用 的 ASPNET MVC 用 户 界面 的 组 合 根 。 


代码 清单 9-25 HttpApp1ication 的 App1ication_Start 方 法 是 Web 应 用 中 一 个 常见 的 组 合 根 


public class MvcApplication : HttpApplication 


{ 
public static UnityContainer Container ; 
protected void Application_sStart() 9 
{ 


AreaRegistration.RegisterAllAreas(); 


FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters); 
RouteConfig.RegisterRoutes(RouteTable.Routes); 
BundleConfig.RegisterBundles(BundleTable.Bundles); 


AutoMapper .Mapper .CreateMap<TaskDto, TaskViewModel1>(); 


Container = new UnityContainer QO; 
Container.RegisterType<ISettings, ApplicationSettings>(); 
Container.RegisterType<IObjectMapper, MapperAutoMapper>QO; 
Container.RegisterType<ITaskService, TaskServiceAdo>QO; 
Container.RegisterType<TaskViewMode1>() ; 
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Container.RegisterType<TaskController>() ; 


ControllerBuilder.Current.SetControllerFactory (new 
UnityControllerFactory(Container)); 
} 
} 





示例 中 的 一 些 代码 就 是 创建 新 MVC 应 用 时 的 默认 模板 代码 ， 它 包括 了 所 有 MVC 模 式 相 关 的 
初始 化 代码 ， 比 如 注册 域 、 过 滤 、 路 由 和 绑 定 等 。 这 些 代码 都 要 尽早 在 App1ication_Start 方 
法 中 执行 。ASPNET 应 用 在 IS 中 局 动 后 ， 第 一 个 收 到 的 请 求 会 触发 调用 App1ication_Start 方 
法 .后 置 代码 文件 Global .asax 包 含 了 HttpApp1ication 类 的 特定 于 应 用 的 子 类 ,App1ication_ 
Start 方 法 也 位 于 该 子 类 的 实现 中 。 

上 面 的 示例 中 , 除了 针对 MVC 的 TaskController 类 外 ， 其余 的 服务 接口 和 实现 都 是 可 以 直 
接 重用 的 。 前 面 一 节 中 的 TaskController 类 是 针对 WPF 编 写 的 ， 因 此 也 不 可 以 在 WPF 以 外 的 上 
下 文中 重用 ， 需 要 编写 新 的 控制 融 类 。 但 是 ， 新 的 TaskContro11er 类 也 和 WPF 版 本 的 控制 硕 类 
做 了 很 多 相同 的 工作 , 包括 获取 任务 数据 , 使 用 IObjectMapper 将 任务 数据 转换 为 视图 友好 的 格 
式 ， 不 同 点 只 是 基于 MVC 探 制 器 的 基 类 。 因 为 TaskContro11er 类 是 继承 System.Web .Mvc. 
Controller 类 的 ,所 以 它 就 是 应 用 的 解析 根 。 代码 清单 9-26 展 示 了 这 个 新 的 TaskContro11er 类 。 


代码 清单 9-26 ”TaskController 是 一 个 解析 根 ， 它 有 一 个 需要 依赖 的 构造 水 数 


public class TaskController : Controller 














{ 
private readonly ITaskService taskService; 
private readonly IObjectMapper mapper.; 
public TaskController(ITaskService taskService, IObjectMapper mapper) 
{ 
this.taskService = taskService; 
this.mapper = mapper; 
} 
public ActionResult List() 
{ 
var taskDtos = taskService.GetAllTasksQ); 
var taskViewModels = mapper.Map<IEnumerable<TaskViewModel>>(taskDtos); 
return View(taskViewModels); 
} 
} 





List 方 法 是 该 类 的 动作 方法 ， 会 被 演 染 所 有 任务 数据 的 同一 个 视图 类 调用 。 在 WPF 应 用 中 ， 
控制 器 首先 委托 ITaskService 来 获取 任务 数据 ， 然 后 使 用 IO0bjectMapper 类 将 这 些 数据 转换 为 
视图 模型 定义 的 数据 类 型 ， 以 供 视图 使 用 。 


9.2 ”比较 复杂 的 注入 275 


注意 ”此 处 使 用 的 也 是 用 于 WPF 的 相同 ViewMode1。 这 样 是 可 行 的 ， 因 为 INotify- 
PropertyChanged 接 口 不 仅仅 用 于 WPF 上 下 文 (该 接口 位 于 System.ComponentMode1 命 名 
空间 )。 然 而 ，MVC 并 不 在 乎 这 个 接口 ， 也 不 会 响应 任何 从 ViewMode1 中 引发 的 事件 。 此 外 ， 
MVC 允 许 你 使 用 校 验 提 示 和 其 他 MVC 程 序 集中 的 类 似 属 性 来 修饰 ViewMode1， 因 此 ,最 好 
还 是 针对 MVC 上 下 文 定 义 新 的 ViewMode1。 








上 默认 情况 下 ，MVC 控 制 带 需要 一 个 公共 的 默认 构造 函数 ,这样 MVC 框 架 才 可 以 在 调用 动作 
方法 前 构造 控制 带 实 例 。 但 是 , 使 用 依赖 注入 时 ,你 需要 的 是 能 接受 所 需 服 务 接口 参数 的 构造 隔 
数 。 笠 运 的 是 ，MVC 使 用 工厂 模式 创建 控制 带 实 例 ， 这 就 为 你 的 控制 融 实 现 提 供 了 扩展 点 。 如 
代码 清单 9-27 所 示 。 


代码 清单 9-27 ”MYVC 框 架 提 供 了 很 多 扩展 点 ， 包 括 能 够 利用 依赖 注入 的 目 定 义 控制 带 工 三 


public class UnityControllerFactory : DefaultControllerFactory 


{ 





private readonly IUnityContainer container ; 


public UnityControllerFactory(IUnityContainer container) 


{ 


this.container = container; 


} 


protected override IController GetControllerInstance(RequestContext requestContext, 
Type controllerType) 


{ 
if (controllerType != null) 
{ 
var controller = container.Resolve(controllerType) as IController; 
if (controller == null) 
{ 
controller = base.GetControllerInstance(requestContext, controllerType); 
} 
if (controller != null) 
return controller; 
} 
requestContext.HttpContext.Response.StatusCode = 404; 
return null; 
} 


当 你 在 Application_Start 方 法 中 构建 UnityControllerFactory 实 例 时 ， 需 要 传人 一 个 
UnityContainer 类 参数 。 如 示例 中 粗 体 高 亮 的 代码 所 强调 的 , 可 以 用 GetControllerInstance 
方法 代替 容器 的 Reso1ve 方 法 ,前 者 可 以 根据 类 创建 所 需 的 控制 句 实 例 。 这 就 是 解析 出 控制 句 ( 解 
析 根 ) 的 地 方 ， 同 时 能 得 到 的 还 包括 对 象 图 中 其 他 可 能 需要 的 对 象 。 

需要 记 住 的 是 , 这 个 示例 中 实例 对 象 的 生命 周期 是 不 同 的 。 应 用 启动 时 ,控制 反 转 容器 就 创 
建 好 了 ， 映 射 关 系 也 注册 了 。 然 而 ， 直 到 有 请 求 发 生 时 才 会 解析 控制 需 实 例 。 每 个 请 求 到 来 时 ， 
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应 用 会 解析 得 到 相应 的 控制 器 实例 ， 当 请 求 处 理 结束 后 ,该 控制 器 实例 就 已 经 超出 了 自己 的 作用 
范围 ， 因 此 不 再 震 要 它 了 。 

3. Windows Forms 

Windows Forms 应 用 中 引导 依赖 注入 的 方式 更 像 WPF 应 用 , 而 不 是 ASPNETMVC 应 用 。 二 者 
的 解析 根 都 是 视图 , 视图 的 构造 函数 需要 传人 的 是 表示 需 或 控制 希 参 数 , 并 由 视图 开始 处 理 整 个 
对 象 图 。 

代码 清单 9-28 展 示 了 Windows Forms 任 务 列表 应 用 前 端的 组 合 根 。 它 位 于 Program 类 的 Main 
方法 中 ， 该 方法 是 Windows Froms 应 用 的 入 口 。 按 照 惯例 ， 让 注册 代码 越 接近 应 用 的 入 口 越 好 。 


代码 清单 9-28 Program 类 的 Main 方 法 是 应 用 的 入 口 点 ， 可 以 作为 一 个 很 好 的 组 合 根 


static class Program 


{ 











public static UnityContainer Container; 


[STAThread] 
static void MainO) 
{ 
AutoMapper .Mapper .CreateMap<TaskDto, TaskViewModel1>(); 


Application.EnableVisualStylesQ); 
Application.SetCompatibleTextRenderingDefault(false); 


Container = new UnityContainer() ; 
Container.RegisterType<I9Settings，Application9ettings>() ; 
Container.RegisterType<IObjectMapper, MapperAutoMapper>QO; 
Container.RegisterType<ITaskService, TaskServiceAdo>QO; 
Container.RegisterType<TaskListController>() ; 
Container.RegisterType<TaskListView>(); 


var mainForm = Container.Resolve<TaskListView>(); 
Application.RunCmainForm) ; 


注意 ， 在 这 个 Windows Forms 应 用 中 ， 你 不 仅 可 以 重用 服务 的 WPF 版 本 实现 ， 也 可 以 重用 
TaskListViewController 类 ， 因 为 它 并 不 依赖 任何 特定 于 WPF 的 东西 。 当 然 , 将 来 很 可 能 会 有 
些 特定 于 WPF 的 依赖 ， 因此 为 支持 Windows Forms 平 台 创建 专门 的 控制 器 或 表示 带 是 有 必要 的 。 
这 个 应 用 的 视图 非常 人 简单， pe 
定 ， 如 代码 清单 9-29 所 示 。 当 你 在 使 用 模型 -视图 -表示 需 模 式 时 ， 视 图 会 实现 一 个 表示 器 ， 从 而 
能 够 手动 委托 调用 以 设置 数据 的 接口 。 


代码 清单 9-29 视图 使 用 数据 绑 定 将 获得 的 任务 列表 设置 到 一 个 数据 表格 控件 上 


public partial class TaskListView : Form 
{ 
public TaskListView(TaskListController controller) 
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InitializeComponent() ; 


controller.OnLoadQO; 
this.taskListControllerBindingSource.DataSource = controller; 


} 


如 果 不 应 用 已 有 平台 来 解析 视图 ， 你 就 必须 先 自己 解析 得 到 视图 实例 ， 然 后 再 把 它 传递 给 
Windows Forms 应 用 的 启动 方法 App1ication.Run。 这 是 在 应 用 只 有 一 个 主 视 图 时 唯一 合适 的 解 
析 点 ,通常 桌面 应 用 都 属于 这 种 情况 。 此 外 ,可 以 使 用 视图 实现 的 控制 需 或 表示 需 创 建 对 话 框 和 
其 他 子 窗 口 。 


9.2.4 约定 优 于 配置 


通过 配置 来 注册 接口 和 相应 实现 类 之 间 的 映射 关系 会 很 费力 ,而 且 随 者 时 间 的 推移 ,也 会 变 
得 繁琐 见长 。 相 反 ， 你 可 以 使 用 约定 来 减少 需要 编写 的 代码 量 。 

约定 是 一 组 指令 , 用 于 告诉 容 需 如 何 目 动 完成 接口 到 相应 实现 类 的 映射 。 容 需 接 受 输入 的 指 
令 ， 而 不 是 注册 。 理 想 情 况 下 ， 容 天 处 理 输入 指令 所 得 到 的 输出 与 你 手动 完成 的 注册 效果 一 样 。 























注意 ”这 里 说 的 “ 优 于 ”也 可 以 解释 为 “可 以 替代 "。 因 此 ， 这 一 节 的 主题 可 以 是 “使 用 约 
天 





代码 清单 9-30 展 示 了 前 面 的 示例 是 如 何 使 用 约定 进行 注册 的 过 程 。 
代码 清单 9-30 ”使 用 约定 可 以 极 大 简化 注册 阶段 的 代码 


private void OnApplicationStartup(object sender, StartupEventArgs e) 


{ 
CreateMappings O; 


container = new UnityContainer() ; 

container.RegisterTypes( 
AllClasses.FromAssembliesInBasePathQO,， 
WithMappings.FromMatchingInterface, 
WithName.Default 

DS 


MainWindow = container.Resolve<TaskListView>0Q; 
Mainwindow.sSshow() ; 


(CTaskListController)MainWindow.DataContext) .OnLoad () ; 
} 


单个 RegisterTypes 方 法 完成 了 所 有 的 注册 过 程 。 该 方法 用 于 给 容 融 提供 如 何 查找 类 以 及 将 





它们 映射 到 相应 接口 的 指令 。 上 面 示例 提供 给 容器 的 指令 包括 以 下 这 些 。 
口 注册 基本 路 径 bin 目 录 下 所 有 程序 集 包 含 的 类 。 
口 把 这 些 类 映射 到 符合 类 命名 约定 的 接口 上 。 这 里 的 约定 (convention ) 是 指 , 名 为 Service 
的 实现 类 的 对 应 接口 的 名 称 应 该 是 IService。 

口 注册 每 个 映射 关系 时 使 用 默认 值 来 命名 映射 。 默 认 值 为 空 代表 了 上 映射 关系 是 未 命名 的 。 

按照 这 些 指 令 ， 容 融会 枚 举 bin 目 录 下 的 每 个 程序 集中 的 每 个 公开 的 类 ， 找 到 它 实 现 的 所 有 
接口 ， 并 把 它 映 射 到 其 中 那个 符合 自己 命名 规则 ( 前 级 为 代表 Interface 的 I ) 的 接口 ， 同 时 并 
不 需要 为 映射 关系 命名 。 不 难 想象 , 这 样 注册 的 结果 要 比 你 手动 注册 生成 的 映射 关系 量 要 大 的 多 。 
然而 ,更 重要 的 是 如 何 保证 正确 地 注册 类 和 接口 的 映射 关系 。 这 也 是 约定 注册 方式 引入 的 新 问题 。 

不 可 否认 , 约定 注册 的 方式 的 确 让 代码 简化 了 很 多 , 但 也 只 局 限 在 代码 量 更 少 的 层次 上 。 通 
过 配置 注册 ， 能 够 很 容易 地 知道 每 个 接口 对 应 的 实现 ， 而 且 能 确保 注册 是 正确 的 。 

RegisterTypes 方 法 的 第 一 个 参数 是 要 注册 类 的 集合 。 静 态 A11Cl1asses 类 提供 的 一 些 辅助 
方法 能 够 通过 一 些 常 见 的 策略 获得 要 注册 类 的 集合 。 第 二 个 参数 是 一 个 函数 , 它 的 输入 参数 是 第 
一 个 参数 获得 的 实现 类 集合 , 输出 的 是 映射 得 到 的 对 应 接口 集合 。 静 态 WithMapping 类 提供 了 一 
些 辅助 方法 以 多 种 策略 来 为 每 个 类 找到 合适 的 接口 。 第 三 个 方法 是 另外 一 个 因数 , 它 会 为 每 个 类 
上 的 映射 关系 返回 一 个 名 称 。 静 态 WithName 类 提供 了 两 个 命名 选项 : 总 是 返回 空 〈 因 此 映射 也 
就 是 未 命名 的 ) 的 Defau1t 和 使 用 类 名 作为 映射 名 称 的 TypeName。 后 者 允许 你 根据 类 名 称 获 取 映 
射 到 的 类 实例 ， 调 用 的 语句 为 Resolve<IService>("MyServiceImplementation")。 

当然 , 上 面 示 例 代 码 中 的 方法 参数 很 通用 , 你 可 以 使 用 任何 符合 参数 签名 要 求 的 其 他 方法 以 
反映 你 需要 的 约定 。 如 代码 清单 9-31 所 示 ,， 约 定 注册 方式 的 关键 点 就 是 用 于 查找 类 ， 建 立 类 和 接 
口 之 间 的 映射 关系 ， 以 及 为 映射 关系 命名 的 约定 。 


代码 清单 9-31 约定 可 以 按照 你 的 需求 进行 定制 


public partial class App : Application 

{ 
private void OnApplicationStartup(object sender, StartupEventArgs e) 
{ 






































CreateMappings O; 


container = new UnityContainer() ; 
container.RegisterTypes( 
AllClasses.FromAssembliesInBasePathQO .Where(type => 
type.Assembly.FullName.Startswith(MatchingAssemblyPrefix)), 
UserDefinedInterfaces ， 
WithName.Default 
8 


MainWindow = container.Resolve<TaskListView>0Q; 
MainwWindow.Show() ; 


((TaskListController)MainWindow.DataContext) .OnLoad() ; 
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private IEnumerable<Type> UserDefinedInterfaces(Type implementingType) 
{ 
return WithMappings.FromAllInterfaces(implementingType) 
.Where(iface => iface.Assembly.FullName.StartsWith(MatchingAssemblyPrefix)); 
} 
} 


这 个 示例 不 再 是 直接 获取 bin 目 录 下 所 有 程序 集中 的 所 有 类 ,而 是 只 查找 那些 符合 指定 前 级 
字符 串 的 程序 集 。 通 常情 况 下 会 使 用 点 分 隔 的 命名 方式 ， 这样 只 需要 去 匹配 名 称 中 的 顶层 命 
空间 即 可 。 所 以 ，Microsoft.Practice.Unity 是 DLL 名 称 ， 也 是 该 DLL 内 所 有 类 的 命名 空间 。 如 果 
bin 目 录 下 有 IMicrosoft.Practice.Unity 这 个 DLL 文 件 ( 如果 你 在 使 用 Unity 的 话 就 一 定 会 有 ), 你 也 
许 想 在 检索 并 建立 映射 关系 时 直接 忽略 它 。 一 种 简单 的 办 法 就 是 只 从 符合 应 用 目 己 的 前 级 的 程 
序 集中 获取 类 。 比 如 ， 你 应 该 使 用 诸如 MyBusiness 或 OurProject 等 来 代替 Microsoft 作 为 文件 名 
称 前 绥 。 

第 二 个 参数 已 经 被 满足 参数 签名 要 求 的 本 地 方法 UserDefinedInterfaces 替 代 。 给 定 一 个 
实现 类 Type， 该 方法 会 将 映射 返回 到 该 类 的 一 个 接口 集合 。 这 里 也 不 需要 自己 编写 特别 复杂 的 
代码 ， 只 需要 调用 WithMappings.FromA11Interfaces 方 法 ， 该 方法 会 返回 指定 类 实现 的 所 有 
接口 。 返 回 的 接口 集合 中 很 可 能 包括 你 并 不 想 要 的 一 些 接口 ,比如 INotifyPropertyChanged 或 
IDataErrorInfo 等 。 所 以 ， 你 还 是 应 该 只 去 检索 那些 符合 你 的 命名 前 绥 规 则 的 程序 集 ， 这 样 可 
以 确保 只 建立 你 自己 的 类 和 接口 之 间 的 映射 关系 。 

1. 优 缺 点 

和 穷人 的 依赖 注入 以 及 控制 反 转 容 需 进行 注册 类 似 ， 使 用 约定 进行 注册 一 样 有 优点 也 有 缺 
点 。 你 要 写 的 代码 量 是 更 少 了 ， 但 是 同时 代码 也 比 其 他 方法 中 声明 式 的 代码 更 难 直 接 理解 了 。 

约定 在 开始 阶段 的 设置 也 更 复杂 。 如 有 果 你 在 编写 真正 的 SOLID 代 码 , 也 不 是 所 有 类 和 接口 之 
间 的 映射 关系 都 是 一 对 一 的 。 实 际 上 ， 只 有 一 个 实现 (不 包括 用 于 单元 测试 的 模拟 实现 ) 的 接口 
的 情况 本 号 就 是 一 个 代码 味道 。 通常 情况 下 , 一 个 接口 都 应 该 有 多 于 一 个 的 具体 实现 , 不论 它们 
是 适配器 、 修 饰 需 或 是 不 同 策略 的 实现 等 ， 而 这 种 现状 也 会 让 按照 约定 注册 变 得 更 复杂 和 困难 。 
注入 类 的 对 象 图 会 变 得 更 加 复杂 , 所 以 很 难 整理 出 一 个 让 类 和 接口 相互 映射 的 规则 。 在 这 种 情况 
下 ,约定 只 会 涵盖 所 需 注 册 代 码 的 一 小 部 分 ， 而 不 像 一 般 情况 那样 涵盖 所 有 注册 代码 。 

Mark Seemann 是 Dependency Injection in .NET ( 2011 年 由 Manning Publications 出 版 ) 一 书 的 作 
者 ， 他 已 经 探索 出 三 种 可 用 的 依赖 注入 方式 并 得 到 了 如 图 9-5 所 示 的 结果 。 简 而 言 之 ， 对 三 种 方 
式 的 取舍 有 两 个 标准 : 价值 和 复杂 度 。 价 值 用 于 衡量 选项 的 作用 和 意义 ， 从 无 意义 到 有 价值 的 。 
复杂 度 用 于 衡量 选项 的 难度 ， 从 简单 的 到 复杂 的 。 如 图 9-5 所 示 ， 三 种 方式 位 于 贝尔 曲线 的 不 同 
位 置 。 穷 人 的 依赖 注入 方式 简单 但 很 有 价值 ， 而 约定 优 于 配置 的 方式 虽然 复杂 但 也 很 有 价值 。 
此 , 它们 二 者 之 间 的 主要 区 别 在 于 , 使 用 约定 要 比 手动 创建 类 和 在 这 些 类 基础 上 构造 出 的 类 对 象 
图 要 更 复杂 一 些 。 





















































280 第 9 章 依赖 注入 原则 


有 价值 的 ， 


简化 的 





意义 的 1 
图 9-5 ”象限 图 中 三 种 依赖 注入 方式 各 有 优 缺 点 
很 有 意思 的 是 ，Seemann 认 为 手动 注册 的 复杂 度 适 中 ， 但 并 没有 实用 价值 。 为 什么 他 这 样 认 








为 呢 ? 主 要 是 因为 使 用 容器 手动 注册 类 型 是 弱 类 型 化 的 。 如 果 你 尝试 把 一 个 类 传递 给 要 求 不 同 参 
数 类 型 的 实例 时 ， 编 译 需 会 在 生成 时 给 出 报错 。 然 而 ， 如 果 你 给 控制 反 转 容 需 传人 不 符合 要 求 的 
类 时 ， 编 译 需 并 不 会 报错 。 相 反 ， 你 只 有 在 运行 时 才能 看 到 出 错 信 息 ， 这 会 让 你 陷 人 一 个 编写 、 
编译 、 运 行 和 测试 的 死 循 环 中 。 不 仅 如 此 ,你 还 需要 花费 很 多 时 间 和 精力 学 习 如 何 使 用 容 需 注册 
映射 关系 ， 但 实际 上 上， 这样 做 是 得 不 偿 失 的 。 

现在 ， 选 择 看 起 来 简单 了 ， 要 么 选择 穷人 的 依赖 注入 ， 要 么 选择 约定 。 如 果 项 目 很 简单 并 且 
只 需要 少量 的 映射 关系 ,此 时 穷人 的 依赖 注入 很 合适 ， 只 需要 手动 构造 对 象 即 可 。 如 果 项 目 变 得 
更 复杂 ， 则 会 需要 建立 很 多 接口 和 类 之 间 的 映射 关系 ,此 时 应 该 使 用 约定 处 理 大 多 数 的 注册 ,其 
余 的 映射 关系 手动 处 理 即 可 。 

我 也 强烈 推荐 大 家 去 阅读 Mark Seemann 的 博客 "， 那 里 有 很 多 他 的 方法 论 相 关 的 主题 ， 所 有 
主题 的 讨论 都 是 有 条 不 闪 的 。 





9.3 总结 


依赖 注入 是 将 本 书 其 他 部 分 结合 在 一 起 的 主线 。 没有 依赖 注入 , 就 无 法 清楚 地 将 依赖 从 类 中 
分 解 出 来 , 也 无 法 将 它们 的 实现 隐藏 在 通用 的 接口 后 。 这 些 扩展 点 对 于 上 自 适 应 代码 的 编写 而 言 非 
常 关键， 也 是 让 逐步 变 大 变 复 杂 的 应 用 稳步 取得 进展 的 关键 。 

实现 依赖 注入 有 多 种 不 同 的 方式 , 每 个 都 有 它 适合 的 场景 。 不 论 你 是 在 使 用 穷人 的 依赖 注入 
或 者 带 有 少量 手动 映射 的 约定 ， 总 是 使 用 依赖 注入 要 比 具 体 的 实现 方式 更 重要 。 

实际 上 , 有 些 常见 的 对 依赖 注入 的 滥用 应 该 被 归 类 到 代码 味道 或 反 模式 中 。 服 务 定位 融和 非 
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法 注入 就 是 两 种 常见 的 滥用 ， 它 们 会 破坏 正确 应 用 依赖 注入 所 得 到 的 很 多 好 人 处 。 

每 个 应 用 都 有 一 个 组 合 根 和 一 个 解析 根 , 二 者 可 以 帮助 你 理解 如 何 利 用 依赖 注入 来 组 织 应 用 
中 的 所 有 类 。 如 果 注 册 过 程 是 应 用 初始 化 的 一 个 主要 问题 , 组 合 根 就 总 是 应 该 非常 接近 应 用 的 人 
口 位 置 。 解 析 根 则 是 唯一 应 该 解析 获取 的 对 象 类 型 。 在 某 些 应 用 中 , 解析 根 只 有 一 个 实例 ， 而 在 
其 他 一 些 应 用 中 ， 解 析 根 类 会 有 一 组 不 同 的 子 类 。 

依赖 注入 对 SOLID 代 码 的 编写 影响 很 大 ,， 它 看 似 简 单 ， 实 则 不 然 。 在 实际 应 用 中 ,强大 的 依 
赖 注入 经 常 无 法 得 到 正确 的 理解 和 应 用 。 
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第 10 章 ” 自 适 应 实例 简介 
第 11 草 自 适应 实例 冲刺 1 
第 12 章 自 适 应 实例 冲刺 2 





本 书 的 这 一 部 分 会 带 你 实践 软件 产品 开发 的 几 个 初始 阶段 。 这 一 部 分 包含 的 三 章 会 从 一 个 
虚拟 的 团队 和 项 目 角度 来 讲解 所 有 团队 成 员 形 成 的 约定 以 及 他 们 如 何 按照 约定 作出 必要 的 决定 。 

这 一 部 分 的 代码 示例 会 讲解 如 何 选择 在 前 两 个 部 分 中 讲解 过 的 模式 和 实践 。 虽 然 无 法 履 盖 
所 有 主题 ， 但 是 也 回答 了 很 多 常见 的 实现 问题 。 

就 像 在 本 书 的 其 他 部 分 中 一 样 ， 你 可 以 从 GitHub 上 下 载 非常 好 用 的 示例 代码 。 有 关 如 何 使 
用 Git 进行 源 代码 控制 的 简要 介绍 ， 请 参见 附录 。 
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完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 了 解 将 要 开发 自 适应 示例 应 用 的 团队 。 

口 理解 该 应 用 的 产品 特性 。 

口 在 第 零 个 冲刺 为 该 应 用 创建 好 初始 的 产品 积压 工作 。 

这 一 部 分 的 三 个 章节 会 按照 Scurm 流 程 以 及 前 面 章 节 讲 解 到 的 自 适应 设计 原则 逐步 构建 出 一 
个 可 以 工作 的 应 用 。 这 是 本 书 至 此 所 有 内 容 的 高 潮 部 分 ， 展示 了 如 何 构 造 出 一 个 清晰 的 全 景 图 。 
在 阅读 剩余 章节 的 内 容 时 ， 我 推荐 你 也 同时 学 习 配 套 的 代码 "。 没 有 本 章 的 讲解 ， 单 独 看 代码 会 
缺乏 上 下 文 信息 。 同 样 ， 如 果 没 有 完整 的 Microsoft Visual Studio 解 决 方案 源 代码 ， 只 通过 后 面 章 
节 中 摘 取 的 示例 代码 清单 也 无 法 看 到 项 目的 全 景 。 

本 章 的 格式 会 尽量 反映 实际 项 目的 场景 , 但 有 些 地 方 会 为 了 简洁 和 清晰 而 做 出 一 些 妥 协 。 接 
下 来 会 在 本 章 介绍 一 个 虚拟 的 Scrum 团 队 以 及 要 开发 产品 的 概要 。 
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下 面 的 示例 应 用 将 会 由 一 个 虚拟 的 名 为 Trey Research 的 公司 开发 ， 他 们 为 自己 具备 编写 出 优 
秀 日 适应 代码 的 能 力 而 瞻 感 日 蒙 。 


10.1.1 团队 


示例 应 用 会 按照 Scrum 流 程 进行 开发 ， 所 以 需要 成 员 担当 Scrum 团 队 中 的 各 个 角色 。 有 关 更 
详细 的 角色 和 Scrum 流 程 介 绍 ， 请 参见 第 1 章 。 

队 包 括 了 产品 从 创建 到 交付 过 程 中 需要 的 所 有 角色 。 产品 负责 人 知道 如 何 获取 想 要 的 应 用 
特性 ， 哪 些 特 性 优先 级 最 高 ， 哪 些 特性 能 为 业务 带 来 最 大 的 收益 。S$crum 主 管 则 负责 团队 使 用 的 
流程 。 他 关注 的 是 , 流程 要 匹配 团队 ,团队 工作 要 没有 障碍 ， 用 户 故 事 开 发 过 程 中 出 现 的 问题 要 
及 时 反馈 给 产品 负责 人 。 开 发 团队 则 包括 了 要 实现 故事 的 几 个 开发 人 员 ， 和 一 个 负责 设计 测试 用 
例 以 及 验证 故事 是 否 达 到 交付 标准 的 测试 分 析 人 员 。 











(DD 有关 如 何 访 问 示 例 应 用 的 代码 以 及 本 书 中 的 其 余 代 码 的 说 明 ， 请 参见 附录 。 
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1. 产品 负责 人 

产品 负责 人 Petra 是 一 位 非常 资深 的 业务 分 析 师 ,最近 刚刚 加 入 Trey Research 人 公司。 她 非常 擅 
长 发 现 用 户 真 正 想 要 的 东西 ， 这 就 是 产品 负责 人 的 一 个 杀手 铀 。 她 很 大 度 地 承认 ,她 并 不 熟悉 各 
种 敏捷 流程 ， 但 是 非常 乐意 学 习 和 实践 产品 负责 人 这 个 新 角色 。 

在 整个 开发 过 程 中 , Petra 一 直 都 和 客户 公司 保持 联络 以 发 现 客户 真正 需要 的 东西 和 需要 它们 
的 理由 。 此 外 , 她 也 会 计算 各 种 不 同 特性 对 于 客户 的 价值 ,从 而 帮助 开发 团队 更 好 地 对 工作 项 进 
行 排序 。 

2. Scrum 主 管 

Steve 在 公司 同时 兼任 两 个 角色 : Scrum 主 管 和 开发 团队 领导 。 公 司 打算 很 快 修正 这 个 兼任 多 
个 角色 的 问题 ， 从 而 让 Steve 只 从 事 他 更 喜欢 的 Scrum 主 管 角色 。 为 此 ， 公 司 正 计 划 聘 任 一 个 资深 
的 开发 人 员 作 为 专职 的 开发 团队 领导 。 

以 Steve 作 为 Scrum 主 管 的 能 力 ， 他 可 以 确保 团队 遵守 S$crum 流 程 ， 让 团队 成 员 对 流程 的 当前 
体现 感到 满意 。 他 为 自己 能 诚信 透明 地 和 任何 指定 的 产品 负责 人 或 客户 协作 而 自 紧 ,因为 他 从 不 
更 改 范围 或 随意 承诺 交付 目标 。 

尽管 Steve 已 经 很 难 有 时 间 去 实际 编写 代码 ， 但 他 仍然 会 参加 设计 会 议 并 竭尽 全 力 让 整个 开 
发 团队 朝 着 正确 的 方向 前 进 。 

3. 开发 人 员 

David 和 Dianne 是 该 公司 的 两 个 专职 开发 人 员 。David 是 一 个 初级 开发 人 员 ， 因 为 他 是 大 学 毕 
业 后 直接 加 入 该 公司 的 ， 而 Dianne 则 处 于 中 级 水 平 。 

Steve 决 定 雇佣 David 的 一 个 原因 是 他 始终 能 坚持 自学 编程 实践 和 技术 .David 总 是 如 饥 似 淘 地 
学 习 最 前 沿 的 开发 技术 。 但 是 , 他 总 是 倾向 于 把 每 个 新 的 技术 看 作 灵 丹 妙 药 且 会 不 加 思考 地 应 用 
在 能 用 到 的 地 方 。 这 说 明了 David 的 实践 能 力 很 好 ， 但 是 他 的 代码 经 常会 包含 大 量 根本 不 需要 的 
中 间 层 。 

Dianne 比 David 的 经 验 更 丰富 ,但 是 她 已 经 厌倦 了 过 去 几 年 出 现 的 技术 浪潮 。 她 也 经 历 过 
David 现 在 正在 遇 到 的 问题 。Dianne 也 想 竞 聘 开发 团队 领导 的 岗位 ， 因 此 她 也 下 决心 要 证 明 自 己 
具备 被 提拔 的 资质 。 为 此 ， 她 也 非常 想必 助 David 取 得 进步 。 

@ 技术 成 熟 度 曲线 

技术 成 熟 度 曲线 是 由 一 个 名 为 Gartner 的 IT 研究 和 咨询 公司 开发 的 。 它 是 一 个 很 好 的 用 来 评估 
新 技能 和 技术 的 工具 。 如 图 10-1 所 示 。 

图 中 x 轴 表 示 时 间 的 推进 ,，y 轴 表示 期 望 。 最 开始 的 是 促 动 期 , 代表 出 现 了 一 个 新 的 技术 发 现 
或 者 一 个 有 用 的 新 技能 或 过 程 。 不 久 后 ， 期 望 值 迅猛 增长 ， 直 到 达到 “期 望 脱 胀 的 项 峰 ”。 在 这 
个 点 上 , 那些 新 的 技术 或 技能 开始 被 认为 并 没有 它们 刚 出 现时 那样 强大 。 这 也 会 导致 后 面 期 望 值 
会 允许 跌落 到 “泡沫 化 的 低谷 期 "。 但 是 ， 这 并 不 代表 结束 了， 因为 经 过 随后 的 “稳步 候 升 的 光 
明 期 ”会 逐渐 过 渡 到 “实质 产 出 的 高 峰 期 ”。 至 此 ， 新 的 技术 或 技能 才 真 正确 立 了 ， 并 且 大 家 对 
它 的 期 望 更 加 现实 。 


性 
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过 度 期 望 的 过 热 期 











实质 产 出 的 高 峰 期 


稳步 疏 升 的 光明 期 


泡沫 化 的 低谷 期 


时 间 
图 10-1 技术 成 熟 度 曲线 可 以 辅助 解释 对 新 技能 和 技术 的 态度 


开发 人 员 对 一 种 或 多 种 编程 技术 或 技能 的 期 望 通常 都 会 位 于 该 技术 成 熟 度 曲 线 的 某 个 位 
置 。 比 如 ， 在 Trey Research 公 司 里 ，David 对 涉及 模式 、SOLID 原 则 、 单 元 测试 以 及 重 构 这 些 技 
术 的 期 望 处 于 过 度 期 望 的 过 热 期 。Dianne 则 刚刚 进入 泡沫 化 的 低谷 期 。 在 本 章 后 面 的 冲刺 会 议 
中 ， 你 要 特别 关注 他 们 的 问题 和 响应， 这样 才 可 以 理解 形成 他 们 在 技术 成 熟 度 曲线 中 所 处 相对 
位 置 上 的 原因 。 

为 了 完整 起 见 ， 需 要 注意 Steve 的 情况 ， 他 的 丰富 经 验 表 明 他 已 经 经 历 了 整个 技术 成 熟 度 曲 
线 ， 他 目前 处 于 实质 产 出 的 高 峰 期 。 不 仅 如 此 ，Steve 已 经 不 会 再 像 以 前 那样 容易 受到 技术 成 熟 
度 曲 线 的 有 影响。 他 在 面 对 那 些 听 说 可 以 增加 生产 力 、 质 量 和 效率 或 其 他 度量 值 的 新 技能 和 技术 时 ， 
会 很 说 屠 。 因 此 ， 在 面 对 一 个 新 的 技能 或 技术 时 ， 他 的 期 望 值 并 不 会 出 现 大 的 波动 。 

4. 测试 分 析 员 

Tom 是 团队 中 的 测试 分 析 员 。 他 主要 负责 测试 自动 化 工作 。 他 一 直 很 擅长 发 现 软件 产 品 的 缺 
陷 以 及 通过 逐步 增加 健壮 性 来 改善 应 用 的 整体 用 户 体验 。 他 喜欢 将 特性 看 作 黑 盒 , 并 不 关心 实现 
细节 ， 只 关心 软件 产品 是 否 能 够 按照 规格 说 明 工 作 。 

Tom 自 己 觉 得 他 在 团队 中 的 工作 量 过 多 ， 因 为 他 要 不 停 地 返工 很 多 已 经 做 过 的 测试 。 也 就 是 
说 ， 在 一 个 故事 达到 验收 标准 前 ,他 至 少 会 测试 两 次 。Tom 很 自 紧 自己 的 工作 可 以 确保 软件 产品 
在 客户 机 右上 很 少 出 现 问 题 ， 因 为 他 的 自动 化 测试 会 早早 发 现 它们 。 





























10.1.2 ”产品 


有 个 客户 已 经 和 Trey Research 公 司 签订 了 合同 , 后 者 会 为 该 客户 开发 一 个 新 的 名 为 Proseware 
的 在 线 聊天 应 用 程序 。 这 是 个 基于 网 络 的 应 用 程序 , 它 文 持 世 界 各 地 的 用 户 同时 在 线 聊天 。 在 和 
客户 初步 沟通 后 , Petra 知 道 客 户 对 该 项 目 有 很 多 想法 , 但 是 客户 决定 一 点 一 点 地 增加 功能 以 便 他 
们 能 够 决定 应 用 程序 的 开发 方向 。Trey Research 公 司 非 常 适 合 该 项 目 ， 因 为 该 公司 的 开发 风格 就 
是 增 量 的 ， 也 具备 平衡 频繁 需求 变更 的 能 

在 项 目 开 始 前 ，Petra 同 客户 进行 了 交谈 ， 这 样 她 就 可 以 给 团队 提供 将 要 开发 产品 的 相关 信息 。 
客户 想 要 Trey Research 托 管 Proseware 这 个 产品 ， 因 此 ， 团 队 可 以 自由 选择 他 们 认为 对 项 目 最 合适 的 
平台 和 工具 。Petra 也 和 客户 确认 了 客户 对 Proseware 产 品 上 用 户 容量 的 需求 。 她 也 同意 了 客户 只 要 求 
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应 用 程序 同时 支持 20 个 用 户 实时 聊天 ， 这 也 变 成 了 Proseware 这 球 软 件 产品 最 重要 的 非 功 能 性 需求 。 

在 团队 动手 写 代码 前 ，Petra 组 织 了 一 个 团队 会 议 , 以 便 所 有 团队 成 员 都 能 参与 项 目 讨论 ， 从 
而 尽力 形成 一 个 最 初 的 用 户 故 事 积压 工作 。 准 备 好 故事 后 ,团队 就 可 以 开始 工作 , 以 便 在 单个 冲 
刺 内 产 出 一 些 可 以 演示 的 东西 。 


10.2 最初 的 产品 积压 工作 


客户 给 Petra 和 团队 提供 了 一 份 Proseware 的 特性 清单 。 这 个 清单 描述 得 很 平淡 ， 团 队 会 议 的 
目标 就 是 将 这 个 描述 转换 为 一 个 或 多 个 用 户 故 事 。 

我 们 把 Proseware 看 作 让 人 们 能 够 在 线 聊 天 的 主 站 点 。 尽管 如 此 , 我 们 明白 罗马 不 是 
一 天 就 可 以 建成 的 , 所 以 我 们 将 目标 做 了 一 定 程度 的 限制 ,以 便 尽 可 能 快 地 看 到 一 些 可 
以 交付 的 东西 。 

尽管 我 们 想 要 允许 用 户 相 互 发 送 图 片 或 文件 , 但 最 关键 的 功能 仍然 以 文字 交流 为 基 
础 。 同 一 房间 内 的 任何 人 都 应 该 能 接收 到 该 房间 内 其 他 人 发 送 的 任何 消息 。 

因为 文字 聊天 非常 重要 ,所 以 我 们 需要 房间 成 员 能 够 相互 发 送 诸如 HTML 之 类 的 格 
式 化 文本 。 当 然 ， 他 们 不 能 使 用 大 量 的 无 意义 的 图 片 和 视频 来 破坏 当前 的 聊天 。 

Proseware 中 的 某 些 会 话 应 该 不 能 被 一 些 用 户 编辑 , 还 有 , 一 些 用 户 应 该 只 能 看 聊天 
信息 ， 但 不 可 以 发 送 。 
Petra 把 这 个 不 长 的 描述 带 到 了 会 议 上 ， 整 个 团队 就 开始 尝试 从 描述 中 识别 出 用 户 故 事 。 


10.2.1 从 描述 中 挖掘 故事 


如 上 市 所 示 ， 有 了 时 客户 会 平 铺 直 和 叙 地 描述 他 们 的 期 望 。 基于 用 户 的 描述 ,团队 必须 从 中 提出 
并 商定 好 要 实现 的 用 户 故 事 。Trey Research 团 队 专 门 安 排 了 一 个 会 议 来 从 客户 提供 的 Proseware 
软件 的 描述 中 找 出 用 户 故 事 。 
PETRA: 好 了 , 现在 开始 会 议 。 大 家 都 有 读 过 这 个 描述 吗 ? (每 个 人 都 点 了 头 ， 脸 
上 露出 一 些 热切 的 神情 ,) 
STEVE: 这 个 描述 里 的 东西 很 多 啊 ! 
DAVID: 不 是 很 多 啊 ， 我 们 很 可 能 一 个 冲刺 就 能 摘 定 它们 。( Steve 哆 嘴 笑 了 起 来 。) 
DIANNE: 我 们 首先 能 做 的 就 是 从 这 个 描述 中 找 出 动词 和 名 词 : 发 送 、 接 收 、 格 式 
化 、 发 送 垃圾 信息 …… 房 间 、 会 话 、 用 户 、 成 员 、 聊 天 ……. 
STEVE: 对 的 ， 描 述 里 的 动 名 词 很 多 啊 。 
PETRAs 作为 二 只 轴 户 :各 他 于 in 以 全 i 
DIANNE: 他 们 就 只 是 用 户 吗 ? 
STEVE: 看 起 来 不 是 只 有 用 户 这 一 个 角色 。 
DAVID: 他 们 一 会 叫 他 们 用 户 ， 一 会 又 叫 他 们 成 员 。 
TOM: 然而 ， 你 不 是 一 个 会 话 的 参与 者 ? 
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STEVE: 也 许 吧 , 但 是 我 们 应 该 使 用 客户 普遍 使 用 的 语言 。 还 有 一 些 围绕 会 话 的 角 
色 只 有 读 取 权 限 ， 确 实 如 此 吗 ? 

DIANNE: 是 的 ， 听 起 来 他 们 要 说 的 是 某 种 权限 系统 。 

PETRA: 请 大 家 先 提 取出 一 个 故事 ， 好 吧 ? 

DAVID: 作为 一 个 成 员 , 我 想 发 送 格式 化 的 文本 以 便 其 他 人 能 够 ……: 查看 …… 是 这 
些 吗 ? 

STEVE: 大 家 都 应 该 先 集中 在 角色 和 行为 上 , 对 吧 ? Petra, 你 能 给 出 业务 价值 信息 吗 ? 

PETRA: 当然 可 以 。 

DIANNE: 好 的 ， 但 是 David 说 的 还 是 太 大 了 ， 像 是 史诗 ,而 不 是 用 户 故事 。 

PETRA: 对 不 起 ， 啥 是 史诗 啊 ? 

DAVID : 0 Dianne 认 为 这 个 故事 太 大 ,无 法 放 进 单个 冲 
刺 中 ， 但 是 我 不 知道 如 何 才 能 把 它 变 "| 

DIANNE: 好 的 ， 什 么 en 先 不 0 这 只 是 客户 要 求 的 
一 种 实现 而 已 ! 就 当成 任意 类 型 的 格式 化 文本 ， 那 么 更 简单 呢 ? 

DAVID: 呢 …… 非 格式 化 的 文本 ? 

STEVE: 也 叫 作 纯 文 本 。( David 不 好 意思 地 笑 了 笑 。) 

DIANNE: 作为 一 个 房间 成 员 ， 我 想 要 给 房间 的 其 他 人 发 送 纯 文本 。( Petra 在 看 有 
没有 人 反对 ， 但 是 大 家 好 像 都 默认 达成 共识 了 。 ) 

TOM: 漂亮 , 伙计 们 , 我 们 的 第 一 个 用 户 故 事 产生 了 1! (除了 Petra, 大 家 开始 鼓掌 。) 

PETRA: 但 是 客 己 要 的 是 格式 化 代码 啊 ? 

STEVE: 别 担 心 ， 那 是 另外 一 个 故事 ， 会 在 纯 文 本 故事 交付 后 处 理 它 。 

PETRA: 好 的 ， 作 为 一 个 房间 成 员 ， 我 想 要 给 房间 的 其 他 人 发 送 格 式 化 文本 。 

STEVE: 两 个 故事 了 ， 还 有 其 他 的 吗 ? 

DAVID: 我 想 要 创建 房间 ， 这 个 应 该 也 是 一 个 故事 吧 ? 

DIANNE: 是 的 ， 我 认为 这 一 定 会 让 那个 人 变 成 房间 的 主人 ， 不 是 吗 ? 作为 房间 的 

人 ， 我 想 要 创建 多 个 房间 以 对 会 话 进 行 分 类 。 

STEVE: 好 的 。 

TOM: 客户 也 说 了 他 们 想 要 发 送 图 片 和 文件 。 

PETRA: 是 的 ， 那 是 另外 一 个 故事 。 

STEVE: 还 有 一 个 : 我 想 创 建 只 读 的 会 话 。 

DIANNE: 这 已 经 是 客户 描述 中 的 最 后 一 句 话 了 ， 所 以 我 觉得 我 们 已 经 找 出 了 所 有 
故事 。 


10.2.2 ”故事 点 估算 


到 现在 为 止 , 团队 成 员 都 同意 他 们 从 客户 需求 中 找 出 了 所 有 的 用 户 故 事 。 下 面 列 出 团队 创建 


的 用 户 故 事 卡片 。 
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口 我 想 给 房间 其 他 人 发 送 纯 文本 。 
口 我 想 创建 多 个 房间 以 对 会 话 进行 分 类 。 
口 我 想 给 房间 其 他 人 发 送 格式 化 文本 。 
口 我 想 发 送 图 片 和 /或 文件 。 
口 我 想 创 建 只 读 的 会 话 。 
团队 把 这 些 卡片 都 摆 在 了 蝎 面 上 ， 他 们 开始 准备 做 故事 点 估算 。 整 个 项 目 只 有 五 个 故事 ,所 
以 团队 选择 使 用 计划 扑克 来 估算 需要 的 工作 量 。 
PETRA: 发 送 纯 文本 应 该 不 会 很 难 ， 对 吧 ? 
DAVID: 我 只 需要 一 个 小 时 ! (Steve 和 Dianne 睁 大 了 眼睛 , Tom 转 了 转自 己 的 眼珠 。) 
STEVE: 啊 ， 你 不 可 以 先 做 这 个 故事 。 因 为 没有 房间 ， 你 都 没有 参与 者 。 
DIANNE: 是 的 ， 虽然 这 个 故事 是 有 依赖 的 ， 但 是 它 并 不 会 改变 这 个 故事 的 估算 
( Steve 点 头 表示 同意 。) 
PETRA: 每 个 人 都 准备 好 点 数 了 吗 ? 
过 了 一 会 ， 所 有 团队 成 员 都 亮 出 了 自己 手中 的 计划 扑克 ， 如 下 所 列 。 
PETRA TOM STEVE DIANNE DAVID 
3 3 5 5 1 
PETRA: 呢 ， 打 分 有 点 乱 。David， 为 什么 只 给 一 个 点 的 估算 啊 ? 
DAVID: 是 啊 , 因 为 几乎 没什么 做 的 啊 : 只 需要 接受 一 些 输入 ， 然 后 把 它们 显示 在 
屏幕 上 。 
DIANNE: 不 只 是 这 些 ，David。 有 很 多 事情 你 没有 考虑 到 。 我 们 需要 把 文本 保存 
在 某 些 地 方 ， 然 后 还 可 以 读 取出 来 。 房 间 的 其 他 成 员 也 需要 读 取 它 。 
STEVE: 的 确 是 这 样 的 ，Dianne 是 对 的 。 我 们 需要 在 这 里 考虑 好 架 和 
DAVID: 噢 ,是 哦 。 SS J 这 样 做 
的 话 ， 就 只 有 写 这 个 消息 的 人 能 看 到 ， 并 不 能 共享 给 其 他 人 。 哇 噢 ， 的确 比 我 刚才 想 的 
难得 多 ! 
PETRA: 好 的 ， 那 我 们 再 来 一 次 估算 ? 
这 一 次 所 有 团队 成 员 很 快 就 亮 出 了 他 们 手中 的 计划 扑克 ， 如 下 所 列 。 





PETRA TOM STEVE DIANNE DAVID 
4 4 4 4 4 
STEVE:， 我 们 能 把 这 个 故事 分 割 成 “ 读 ” 和 “ 写 ” 两 个 部 分 吗 ? 


DIANNE: 不 好 意思 ， 你 是 指 ? 

TOM: 我 想 他 的 意思 是 我 们 可 以 有 一 个 故事 用 来 查看 发 送 到 一 个 房间 中 的 所 有 消 
息 ， 另 外 一 个 故事 用 来 向 指定 房间 发 送 消息 。 对 吧 ，Steve? 

STEVE: 是 的 ， 蕊 关中 次 为 省 痒 划分 有 忠于 必 和 认 志 雪灾 可 能 小 的 故事 开始 。 我 知 
道 五 个 点 的 估算 也 不 大 ， 但 是 在 开发 的 初始 阶段 ， 五 个 点 还 是 挺 大 的 。 
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DIANNE: 好 的 ， 我 也 觉得 这 样 划 分 会 更 好 。 那 我 们 重新 给 发 送 消息 估算 点 数 吧 ? 


PETRA TOM STEVE DIANNE DAVID 
3 3 3 3 3 
DIANNE: 现在 我 们 开始 估算 故事 : 查看 已 经 发 送 到 一 个 房间 的 消息 。 
PETRA TOM STEVE DIANNE DAVID 
2 3 2 办 1 


STEVE: Tom、David， 你 们 同意 两 个 点 吗 ? 

TOM: 好 的 ， 两 个 点 也 可 以 。 

DAVID: 我 也 同意 ， 两 个 点 没 问 题 。 

STEVE: 很 好 ， 它 就 是 两 个 点 的 故事 了 。( Steve 给 这 个 故事 标 上 了 两 个 点 ， 然 后 读 
出 下 一 个 故事 。) 我 想 创建 多 个 房间 以 对 会 话 进 行 分 类 。 

DIANNE: 我 们 该 怎样 演示 这 个 呢 ? 

TOM: Petra 和 我 聊 过 这 个 ， 其 中 一 个 验收 标准 就 是 应 该 能 够 查看 已 经 创建 的 房间 
列表 。 

DIANNE: 这 个 也 可 以 分 割 为 “ 读 ” 和 “ 写 ” 两 个 故事 吧 ? 

STEVE: 嘿 ， 我 也 这 样 想 。 

DIANNE: 我 们 先 给 出 读 取 部 分 的 估算 : 我 想 要 查看 房间 列表 。 


所 有 团队 成 员 给 出 了 他 们 的 点 数 估算 ， 如 下 所 列 。 


PETRA TOM STEVE DIANNE DAVID 
2 人 2 2 2 2 
DIANNE: 哇 哦 ， 心 有 灵犀 啊 。 那 么 创建 新 房间 的 故事 呢 ? 
所 有 团队 成 员 再 次 给 出 了 他 们 的 点 数 估算 ， 如 下 所 列 。 
PETRA TOM STEVE DIANNE DAVID 
2 2 2 2 1 
STEVE: David， 你 党 得 两 个 点 可 以 吗 ? 
DAVID: 是 的 ， 我 可 以 接受 。 
STEVE: 下 一 个 故事 : 我 想 要 给 房间 的 其 他 成 员 发 送 格式 化 文本 。 
PETRA: 这 只 是 在 前 面 故 事 的 基础 上 增加 个 格式 化 文本 的 工作 ， 对 吧 ? 
STEVE: 是 的 ， 前 提 是 纯 文 本 的 故事 必须 先 完成 ， 因 为 它 是 这 个 故事 的 前 提 条 件 。 
TOM: 客户 到 底 需 要 什么 样 的 格式 化 呢 ? 内 误 的 图 片 或 其 他 只 东西? 
DAVID: 图 片 是 另外 一 个 故事 。 我 认为 这 里 的 格式 化 是 指 诸 如 粗 体 、 斜 体 、 下 划 线 等 。 
PETRA: 是 的 ,这 也 是 客户 想 要 的 。HTML 是 一 个 他 们 能 想到 的 格式 ， 但 是 我 不 认 
为 我 们 想 要 做 HTML 格 式 。 只 是 简单 的 文本 格式 化 ， 其 他 都 不 需要 。 
STEVE: 好 的 ， 准 备 好 估算 了 嘛 ? 
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所 有 团队 成 员 给 出 了 他 们 的 点 数 合算 ， 如 下 所 列 。 


PETRA TOM STEVE DIANNE DAVID 
1 1 1 1 1 


STEVE: 啊 哈 ， 我们 很 有 默契 啊 。 那 么 ， 下 一 个 故事 : 我 想 要 发 送 图 片 和 /或 文件 。 

DIANNE: 我 不 喜欢 故事 里 的 “和 /或 ”。 我 们 能 把 这 种 歧义 消除 掉 吗 ? 

TOM: 好 的 ， 那 么 发 送 图 片 和 发 送 文件 之 间 有 区 别 吗 ? 

PETRA: 根据 我 和 客户 的 讨论 , 他们 是 想 用 户 能 在 浏览 器 中 直接 查看 图 片 ， 而 文件 
则 是 要 下 载 到 用 户 的 机 器 上 。 

DAVID: 这 实际 上 是 两 个 故事 了 ,不 是 吗 ? 一 个 是 下 载 文件 , 另外 一 个 是 显示 图 片 。 

DIANNE: 完全 正确 ， 作 为 一 个 故事 有 些 太 大 了 ， 我们 是 应 该 把 它们 分 开 。 而 且 似 
乎 下 载 文 件 这 个 故事 会 更 小 些 , 因此 我 们 应 该 先 完成 它 , 后 面 显 示 图 片 的 故事 会 以 下 载 
文件 为 基础 。 

STEVE: 我 同意 。 那 我 们 先 就 把 它 分 成 两 个 故事 吧 。 我 想 要 给 房间 的 其 他 成 员 发 文 
件 。 我 想 在 房间 显示 图 片 。 我 们 来 一 个 一 个 估算 。 


所 有 团队 成 员 给 出 了 第 一 个 故事 的 点 数 估算 ， 如 下 所 列 。 


PETRA TOM STEVE DIANNE DAVID 
5 5 3 3 3 


STEVE: 哦 ? 你 们 两 个 为 何 给 的 是 五 个 点 的 估算 ? 

TOM: 测试 这 个 故事 会 比较 难 。 我 们 还 需要 考虑 很 多 不 常见 的 测试 用 例 。 比 如， 
如 果 发 送 的 文件 很 大 ? 如 果 文 件 是 病毒 ? 是 否 要 在 我 们 的 服务 器 上 保持 文件 ? 如 果 要 
的 话 ， 要 保存 多 久 ? 

STEVE: 我 同意 你 的 观点 。 我 刚才 只 考虑 了 开发 的 工作 量 , 抱歉 。 我 现在 也 相信 你 
需要 花费 很 多 时 间 来 设计 测试 用 例 。 

DAVID: 我 们 是 要 重新 估算 ， 还 是 按照 五 个 点 的 估算 来 ? 

STEVE: 我 觉得 五 个 点 是 合适 的 。 

DIANNE: 我 也 一 样 。 

STEVE: 那么 在 浏览 器 显示 图 片 呢 ? 

PETRA: 这 只 是 在 网 页 上 给 用 户 展示 下 载 的 图 片 ， 对 吧 ? 

STEVE: 是 的 ， 上传 文 件 的 功能 已 经 包括 在 上 一 个 故事 里 面 了 ,所 以 这 个 故事 只 是 
在 网 页 上 显示 文件 。 


团队 成 员 给 出 了 这 个 故事 的 点 数 合算 ， 如 下 所 列 。 


PETRA TOM STEVE DIANNE DAVID 
3 3 3 3 5 


STEVE: David， 这 个 还 需要 五 个 点 吗 ? 





DAVID: 的 确 是 的 。 我 认为 这 个 故事 实际 要 比 它 看 起 来 难 一 些 。 如 果 图 片 不 适宜 显示 
呢 ? 如 果 用 户 很 多 ， 而 且 图 片 下 载 时 间 比 较 长 呢 ? 这 会 给 我 们 的 服务 器 带 来 较 大 的 负载 。 

DIANNE: 我 也 同意 这 些 都 是 要 担心 的 事情 ， 但 是 我 个 人 认为 它们 暂时 超出 了 需求 范 
围 。Petra， 你 要 记得 去 问 问 客户 是 否 想 要 内 容 过 滤 的 功能 ,不 仅仅 针对 图 片 ， 也 可 以 用 于 
文字 。 但 是 ， 现 在 我 们 只 需要 支持 最 多 20 个 用 户 ， 这 应 该 不 会 给 服务 器 带 来 明显 的 负载 。 

PETRA: 内 容 过 滤 功 能 这 个 主意 很 好 ，David。 

STEVE: David， 现 在 可 以 接受 三 个 点 的 估算 吗 ? 

DAVID: 如 果 是 这 样 ， 我 认为 实际 上 两 个 点 就 足够 了 ! 不 过 ， 三 个 点 也 可 以 。 

STEVE: 不 错 ， 现 在 只 剩 最 后 一 个 故事 了 : 我 想 要 创建 只 读 的 会 话 。 


所 有 团队 成 员 给 出 了 他 们 的 点 数 佑 算 ， 如 下 所 列 。 


PETRA TOM STEVE DIANNE DAVID 
8 1 5 8 3 


STEVE: 天 哪 ， 这 次 打分 有 些 随意 啊 ! Tom， 你 的 一 个 点 的 依据 是 什么 ? 

TOM: 抱歉 ,我 没 考虑 到 分 析 和 开发 的 工作 量 了 。 只 是 这 个 故事 真 的 要 上 比 其 他 故 
事 容易 测试 得 多 。 

STEVE: 好 的 。Petra、Dianne， 你 们 两 个 的 八 点 又 是 怎么 得 出 来 的 ? 

DIANNE: 到 现在 为 止 , 还 没有 涉及 必要 的 角色 或 权限 ,我 认为 这 需要 很 多 工作 要 做 。 

DAVID: 响 , 我 不 认为 我 们 现在 需要 角色 或 权限 的 功能 。 我 认为 我 们 只 需要 把 菜 个 
会 话 标记 为 只 读 即 可 。 

STEVE: 只 读 是 针对 每 个 用 户 而 言 的 。 但 是 , 我 依然 不 认为 我 们 需要 复杂 的 权限 或 
角色 基础 架构 。 我 认为 应 该 先 从 最 简洁 的 方案 开始 实现 ， 后 期 再 做 更 完善 的 设计 。 

DIANNE: 这 样 也 行 。 

PETRA: 好 ， 我 相信 大 家 的 选择 。 

STEVE: 平均 估算 值 为 五 个 点 ， 我 们 就 按 五 个 点 来 ? (大 家 都 表示 同意 。) 

STEVE: David,， 你 现在 还 认为 这 些 工作 一 个 冲刺 就 做 得 完 吗 ? 

DAVID: 嘿嘿 …… 不 。 


会 议 圆满 结 
士 
1 0.3 操 结 


整个 会 议 , 团队 先 对 客户 提供 的 需求 描述 进行 了 分 解 ， 并 得 到 了 耕 干 个 用 户 故 事 。 然 后 ， 整 
个 团队 逐个 对 故事 点 数 进行 了 佑 算 , 并 创建 了 一 个 排 好 序 的 积压 工作 。 他 们 现在 可 以 动工 开发 了 。 

注意 ,讨论 过 程 中 是 允许 开发 过 程 中 所 有 角色 参与 信 算 的 ,包括 分 析 、 实 现 和 测试 。 对 于 每 
个 故事 ， 团 队 对 完成 整个 故事 所 需 的 工作 量 都 达成 了 共识 。 
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完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 
口 观摩 团队 第 一 个 冲刺 中 计划 会 议 的 过 程 。 
口 追踪 第 一 个 用 户 故 事 的 实现 和 演进 过 程 。 
口 观摩 团队 第 一 个 冲刺 中 冲刺 演示 和 回顾 会 议 的 过 程 。 
本 章 中 ，Trey Resarch 团 队 实 现 了 前 四 个 用 户 故 事 。 这 四 个 故事 是 项 目 第 一 个 冲刺 的 交付 目 
团队 还 设置 了 下 面 的 冲刺 目标 。 
能 展示 动态 的 房间 列表 ， 能 创建 新 房间 ， 能 查看 在 房间 发 布 的 信息 ， 同 一 房间 内 至 
少 两 个 用 户 可 以 共享 消息 。 
通过 定义 冲刺 目标 , 团队 设 定 了 一 些 有 挑战 但 依然 可 以 在 这 个 冲刺 完成 的 任务 项 。 所 有 具体 
的 工作 项 都 必须 符合 冲刺 目标 ， 以 确保 团队 的 工作 没有 偏离 客户 的 需求 。 
11.1 计划 会 议 
团队 安排 了 冲刺 计划 会 议 并 且 带 去 了 与 冲刺 目标 相关 的 用 户 故 事 。 对 于 第 一 个 冲刺 , 要 实现 
的 故事 包括 以 下 这 些 。 
口 我 想 要 创建 多 个 房间 以 对 会 话 进行 分 类 。 
口 我 想 要 查看 代表 会 话 的 房间 的 列表 。 
口 我 想 要 查看 发 送 到 一 个 房间 内 的 消息 。 
口 我 想 要 给 房间 内 的 其 他 成 员 发 送 纯 文本 消息 。 
团队 开始 了 他 们 的 讨论 过 程 。 
PETRA: 好 , 开始 开会 了 。 今 天 只 要 讨论 四 个 故事 , 但 它们 都 需要 在 这 个 冲刺 交付 ， 
因此 我 希望 今天 的 会 议 能 做 出 一 些 关键 的 决定 。 
STEVE: 别 ,可 能 吧 。 我 们 肯定 需要 在 开始 前 考虑 一 些 技术 问题 。 大 家 都 有 啥 建议 ? 
DIANNE: 这 是 一 个 网 络 应 用 程序 ， 所 以 我 们 应 该 使 用 我 们 都 觉得 熟悉 和 满意 的 平 
台 。 似 乎 ASP.NET 很 明显 是 一 个 很 好 的 选择 ， 大 家 都 同意 吗 ? 
STEVE: 我 同意 。 
DAVID: 呢 。 说 实话 ， 我 认为 这 是 一 个 能 完美 应 用 Node.js 的 应 用 程序 。 





标 


O 〇 











TOM: 不 好 意思 ， 我 没有 使 用 过 Node。 有 人 用 过 吗 ? 

STEVE: 我 也 不 是 很 熟悉 。 我 认为 Dianne 是 对 的 ， 我 们 应 该 坚持 使 用 我 们 都 知道 的 
方式 。 

DIANNE: 基于 MVC, 我 们 已 经 有 了 很 多 基础 的 代码 结构 可 供 我 们 使 用 。 大 家 一 起 
看 看 这 个 时 序 图 。 


Dianne 向 团队 展示 了 UML 时 序 图 ， 如 图 11-1 所 示 。 


ee 


+ 一 一 创建 视图 
<--- -设置 视图 模型 --- 






把 数据 转换 
为 视图 模型 





图 11-1 Dianne 的 时 序 图 能 描述 通用 的 MVC 应 用 程序 2 # 构 

STEVE: 好 的 ， 我 理解 这 个 时 序 图 ， 目 前 也 同意 你 的 设计 。 

DAVID: 但 是 ， 这 个 时 序 图 看 起 来 和 我 们 要 讨论 的 房间 和 消息 没有 任何 关系 啊 。 

DIANNE: 表面 看 是 没有 关系 ， 不 过 我 会 给 出 进一步 的 解释 的 。 这 是 一 个 通用 的 时 
序 图 。 我 决定 不 去 为 每 个 用 户 故 事 创 建 时 序 图 ,而 是 创建 一 个 通用 的 方案 以 便 让 我 们 都 
清楚 需要 什么 样 的 类 ， 至 少 是 那些 目前 看 起 来 就 需要 的 类 。 

DAVID: 噢 ， 我 明白 了 。 所 以 获取 数据 (Get data ) 就 是 获取 房间 (Get room ) 和 
获取 消息 (Get message ) 的 占 位 符 ， 对 吗 ? 

DIANNE: 是 的 ， 你 的 理解 是 对 的 。 

STEVE: 那么 , 服务 部 分 是 指 什么 呢 ? 它 是 事件 驱动 的 消息 系统 或 者 是 某 种 我 们 要 
操作 的 数据 库 系 统 吗 ? 

DIANNE: HTTP 是 一 个 离线 的 无 状态 协议 。 我 们 必须 为 消息 引入 服务 。 

DAVID: 但 是 最 后 一 次 检查 的 只 有 消息 。 我 们 并 不 想 要 总 是 返回 所 有 消息 。 

STEVE: 是 的 ， 这 样 做 扩展 性 也 不 太 好 。 
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DIANNE: 说 到 这 里 ， 这 是 一 个 可 扩展 的 方案 吗 ? 

PETRA: 问 得 好 。 尽 管用 户 短期 只 要 求 最 多 支持 20 个 用 户 , 但 可 以 说 这 个 需求 很 快 
就 会 改变 的 。 而 且 我 们 现在 也 可 能 知道 最 大 限制 数目 。 我 们 不 应 该 限制 应 用 程序 后 续 的 
扩展 性 。 

STEVE: 后 续 并 没有 限制 扩展 性 。 只 要 我 们 从 一 开始 就 编写 具备 良好 自 适应 能 力 的 
代码 ， 就 应 该 能 够 在 我 们 取得 进展 的 过 程 中 发 现 最 合适 的 架构 方案 。 

TOM: 那么 用 户 界 面 呢 ? 如 果 我 们 打算 下 一 周 就 做 演示 ， 它 就 应 该 有 些 演示 的 模 
样 了 。 

PETRA: Tom 是 对 的 。 很 多 时 候 ， 演 示 功 能 虽然 很 强大 ,但 是 用 户 界 面 却 很 糟糕 ， 
这 会 让 用 户 很 大 程度 上 失去 对 我 们 的 信心 。 

DAVID: 好 了 ，MVC 使 用 引导 程序 ， 所 以 我 们 可 以 实现 一 些 引 导 模 板 。 我 们 会 需要 
一 个 房间 列表 页 面 和 一 个 房间 内 消息 的 页 面 。 即 使 是 很 简单 的 风格 ， 但 至 少 要 将 它们 设 
计 得 现代 感 强 一 些 。 

PETRA: 不 要 担心 风格 过 于 简单 。 我 认为 后 续 无 论 如 何 都 要 允许 用 户 自 定 义 显 示 主 
题 的 。 在 早期 阶段 ， 任 何 试图 对 用 户 界面 做 额外 美化 的 努力 都 可 能 是 白费 功夫 。 

STEVE: Tom， 有 关 测 试 ， 你 有 什么 问题 吗 ? 

TOM: 没有 ,根据 我 们 的 冲刺 目标 ,我 确认 最 多 只 有 两 个 用 户 ， 所 以 我 可 以 把 自 
动 加 载 测试 朝 后 推迟 一 些 。 在 我 把 自动 化 测试 环境 搭建 起 来 之 前 ， 可 以 先 集中 做 一 些 手 
动 测试 。 当 然 , 我 肯定 希望 你 们 三 个 人 都 自觉 完成 单元 测试 ， 所 以 ,如 果 后 续 你 们 需要 
有 关 测 试 的 帮助 ， 要 记得 及 时 告诉 我 。 

STEVE: 很 好 ， 我 们 就 先 这 样 。 可 以 在 需要 时 再 进一步 讨论 具体 的 细节 问题 。 
会 议 结束 后 ， 团 队 已 经 开始 准备 实现 第 一 个 故事 了 。 

11.2 “我 想 创建 多 个 房间 以 对 会 话 进行 分 类 ” 
两 天 后 ，David 说 他 做 好 创建 房间 故事 代码 评审 的 准备 了 。Dianne 直 接 去 了 David 的 开发 座位 
前 ， 两 个 人 一 起 讨论 代码 。 讨 论 的 目的 是 为 了 识别 实现 的 优 缺 点 。 这 样 的 同行 评审 能 给 开发 人 员 


一 个 机 会 来 识别 是 否 有 些 实现 没有 达标 或 缺乏 适应 变更 的 能 力 , 因此 在 将 代码 提交 到 源 代码 控制 
系统 前 ， 评 审 是 最 后 一 次 变更 方案 实现 的 机 会 。 
11.2.1 控制 器 
当 David 开 始 实现 控制 需 时 ， 他 加 Dianne 征 求 意见 。 
DAVID: 现在 ， 我 已 经 按照 你 的 建议 应 用 了 MVC 模 式 。 控 制 器 本 身 并 没 做 多 少 事 
情 ， 它 只 是 委托 IRoomRepository 接 口 来 和 我 们 要 使 用 的 持久 存储 模块 交互 。 
DIANNE: 让 我 们 先 看 看 控制 器 的 代码 吧 。 
David 给 Dianne 展 示 了 控制 硕 的 实现 代码 ， 如 代码 清单 11-1 所 示 。 
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代码 清单 11-1 RoomController 是 Create 请 求 的 入 口 点 


public class RoomController : Controller 


{ 
private readonly IRoomRepository roomRepository; 
public RoomController(IRoomRepository roomRepository) 
{ 
Contract.Requires<ArgumentNullException>(roomRepository != null); 
this.roomRepository = roomRepository; 
} 
[HttpGet] 
public ActionResult List() 
{ 
return View(); 
} 
[HttpGet] 
public ActionResult Create(Q) 
{ 
return View(new CreateRoomViewModel1()); 
} 
[HttpPost] 
public ActionResult Create(CreateRoomViewModel model) 
{ 
ActionResult result; 
if(ModelState.IsValid) 
{ 
roomRepository.CreateRoom(model.NewRoomName); 
result = RedirectToAction("List"); 
} 
else 
{ 
result = View("Create", model); 
} 
return result; 
} 
} 


DIANNE: 好 的 ， 看 起 来 不 错 。 我 们 从 构造 函数 得 到 了 注入 的 IRoomRepository 
接口 依赖 ,这 样 就 给 了 我 们 一 些 灵活 性 。 而 且 通 过 构造 函数 入 口 的 契约 能 保证 它 不 为 空 ， 
这 很 好 。 

DAVID: 是 的 ， 我 也 有 单元 测试 来 确保 这 个 不 为 空 的 前 置 条 件 。 如 果 你 要 看 ， 我 
可 以 给 你 看 看 。 

DIANNE: 那样 很 好 ， 但 是 现在 你 先 能 为 我 解释 一 下 POST 请 求 处 理 器 的 Create 方 
法 吗 ? 具体 讲 ， 为 什么 该 方法 在 委托 存储 库 的 CreateRoom 方 法 后 还 要 重 定向 到 列表 动 
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作 上 呢 ? 

DAVID: 这 是 PRG ( Post-Redirect-Get ) 模式 。 从 根本 上 讲 ， 如 果 我 们 这 个 时 候 直 接 返 
回 List 视 图 的 话 , 用 户 任何 刷新 页 面 的 尝试 都 会 产生 第 二 个 POST 请 求 。 这 将 意味 着 我 们 会 
尝试 用 相同 的 名 称 再 创建 一 个 房间 ， 而 且 从 用 户 体 验 角度 上 讲 ， 这 肯定 是 不 对 的 。 

DIANNE: 漂亮 ! 这 个 模式 现在 用 在 这 里 很 合适 。 

DAVID: 有 件 事 我 还 不 太 确定 ， 是 直接 实例 化 新 的 CreateRoomViewMode1， 还 是 
应 该 使 用 一 个 工厂 类 ? 

DIANNE: 问 得 好 。 我 个 人 认为 在 这 个 用 例 中 是 不 需要 使 用 工厂 的 。 因 为 看 起 来 返 
回 值 的 类 型 不 太 可 能 发 生变 化 。 视 图 模型 的 应 用 场景 也 比较 有 限 ， 所 以 不 需要 增加 中 间 
层 来 委托 工厂 返回 视图 模型 的 实例 。 

空 制 器 单元 测试 
David 打 开 了 包括 单元 测试 的 文件 ， 请 求 Dianne 对 他 的 工作 进行 同行 评审 。 文 件 内 容 如 代码 
清单 11-2 所 示 。 

DAVID: 以 下 是 RoomContro11er 构 造 函 数 的 单元 测试 。 


代码 清单 11-2 ”通过 单元 测试 验证 RoomContro11er 构 造 晒 数 


[Test] 
public void ConstructingWithoutRepositoryThrowsArgumentNullException() 
{ 
Assert.Throws<ArgumentNullException>(() => new RoomController(null)); 
} 
[Test] 
public void ConstructingWithValidParametersDoesNotThrowException() 
{ 
Assert.DoesNotThrow(() => CreateControllerQO); 
} 


DAVID: 第 一 个 测试 确保 了 RoomController 类 的 TRoomRepository 接 口 字 段 始 终 
有 效 。 
DIANNE: 是 的 ， 这 是 RoomContro11ler 类 的 一 个 隐 仿 的 契约 ， 那 就 是 存储 库 字 段 
必须 不 为 空 且 有 效 。 
DAVID: 接 下 来 的 两 个 测试 是 为 了 对 响应 GET 请 求 的 Create 方 法 行为 的 断言 。 
David 下 拉 文 件 滚动 条 并 找到 了 如 代码 清单 11-3 所 示 的 两 个 测试 。 
代码 清单 11-3 ”针对 Create 动 作 的 GET 请 求 的 单元 测试 


[Test] 
public void GetCreateRendersView() 


{ 





var controller = CreateController(); 


var result = controller.Create(); 
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Assert.That(result, Is.InstanceOf<ViewResult>()); 
} 


[Test] 
public void GetCreateSetsViewModel() 
{ 


var controller = CreateControllerQO); 
var viewResult = controller.Create() as ViewResult; 


Assert.That(viewResult.Model, Is.InstanceOf<CreateRoomViewModel> OO); 


DAVID: 我 们 需要 明和 白 两 件 事 : 请 求 会 返回 一 个 ViewResult 类 实例 ， 以 及 Mode 届 
性 的 期 望 类 应 该 是 CreateRoomViewMode1 类 。 

DIANNE: 你 能 把 这 两 个 单元 测试 合并 为 同时 有 两 个 断言 的 一 个 测试 吗 ? 

DAVID: 我 觉得 可 以 , 但 是 合并 起 来 后 的 单元 测试 名 称 就 不 会 像 现 在 这 样 清晰 地 表 
达 它 的 断言 意图 了 。 我 更 愿意 编写 粒度 合适 的 测试 , 这 些 目标 明确 的 测试 包含 了 尽 可 能 
少 的 断言 ， 也 有 助 于 更 容易 地 识别 错误 行为 。 

DIANNE: 挺 好 的 。 那 么 如 何 断 言 POST 请 求 中 那个 委托 服务 完成 动作 的 Create 动 
作 呢 ? 

DAVID: 这 是 针对 它 的 单元 测试 。 


David 再 次 向 下 滚屏 ， 给 Dianne 展 示 了 如 代码 清单 11-4 中 所 示 的 单元 测试 。 
代码 清单 11-4 ”针对 Create 动 作 的 POST 请 求 的 单元 测试 


[Test] 

[TestCase(null1)] 

[TestCase("")] 

[TestCase(” *) 

public void PostCreateNewRoomWithInvalidRoomNameCausesValidationError(string roomName) 
{ 


var controller = CreateController(); 
var viewModel = new CreateRoomViewModel { NewRoomName = roomName }; 


var context = new ValidationContext(viewModel, serviceProvider: null, items: null); 
var results = new List<ValidationResu1lt>() ; 


var isValid = Validator.TryValidateObject(viewModel, context, results); 


Assert.That(isValid, Is.False); 
} 


[Test] 
[TestCase(null)] 
[TestCase("")] 
[TestCase(” ba) 


11.2 “我 想 创建 多 个 房间 以 对 会 话 进行 分 类 ” 7299 


public void PostCreateNewRoomWithInvalidRoomNameShowsCreateView(string roomName) 


{ 
var controller = CreateController() ; 
var viewModel = new CreateRoomViewModel { NewRoomName = roomName }; 
controller.ViewData.ModelState.AddModelError("Room Name", "Room name is required"); 
var result = controller.Create(viewModel); 
Assert.That(result, Is.InstanceOf<ViewResult>()); 
var viewResult = result as ViewResult; 
Assert.That(viewResult.View, Is.Null); 
Assert.That(viewResult.Model, Is.EqualTo(viewModel)); 
} 
[Test] 
public void PostCreateNewRoomRedirectsToViewResult() 
{ 
var controller = CreateController() ; 
var viewModel = new CreateRoomViewModel| { NewRoomName = "Test Room” }; 
var result = controller.Create(viewModel); 
Assert.That(result, Is.InstanceOf<RedirectToRouteResult>(O)); 
var redirectResult = result as RedirectToRouteResult; 
Assert.That(redirectResult.RouteValues["Action"], Is.EqualTo("List")); 
} 
[Test] 
public void PostCreateNewRoomDelegatesToRoomRepositoryQ) 
{ 
var controller = CreateController() ; 
var viewModel = new CreateRoomViewModel| { NewRoomName = "Test Room” }; 
controller.Create(viewModel); 
mockRoomRepository.Verify(repository => repository.CreateRoom("Test Room")); 
} 


DAVID: 前 两 个 测试 对 必须 的 房间 名 称 字段 进行 了 断言 。 为 了 创建 房间 ， 必 须要 提 
供 房 间 名 称 。 如 果 验 证 出 错 ， 用 户 会 被 拉 回 创建 房间 的 页 面 。 

DIANNE: 用 TestCase 属 性 来 为 单元 测试 指定 错误 的 房间 名 称 ， 这 种 方式 不 错 ， 
我 很 喜欢 。 

DAVID: 谢谢 夸奖 。 我 认为 这 样 可 以 少 写 点 测试 方法 。 

DIANNE: 到 目前 都 插 好 ， 我 们 看 下 一 个 吧 。 





11.2.2 ”房间 存储 库 
David 不 太 确 定 自己 对 房间 存储 库 的 实现 是 否 正确 。 他 打开 该 类 的 实现 文件 以 便 Dianne 能 提 
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供 评 审 建议 和 意见 。 文 件 内 容 如 代码 清单 11-5 所 示 。 
DAVID: 我 创建 了 IRoomRepository 接 口 的 ADO.NET 版 本 的 实现 。 你 看 看 。 


代码 清单 11-5 AdoNetRoomRepository 人 允许 在 任何 ADO.NET 兼 容 数 据 库 中 存储 Room 数 据 


public class AdoNetRoomRepository : IRoomRepository 


public AdoNetRoomRepository(IConnectionIsolationFactory factory) 


this.factory = factory; 


public void CreateRoom(string name) 


factory.WithCconnection => 


using(var transaction = Connection.BeginTransaction()) 


{ 


var command = connection.CreateCommand(); 
command.CommandText = "dbo.create_room"; 
command.CommandType = CommandType.StoredProcedure; 
command.Transaction = transaction; 

var parameter = Command.CreateParameter() ; 
parameter.DbType = DbType.String; 
parameter.ParameterName = "name"; 

parameter.Value = nanme; 
command.Parameters.Add(parameter); 


command .ExecuteNonQuery() ; 


private readonly IConnectionIsolationFactory factory 


{ 
{ 
} 
{ 
{ 
br)3 
} 
} 


DAVID: 我 在 这 里 使 用 了 工厂 隔离 模式 , 我 委托 一 个 工厂 接口 来 控制 数据 库 连 接 对 
象 的 生命 周期 。CreateRoom 方 法 体 只 是 一 些 标准 的 ADO.NET 代 码 。 
DIANNE: 咖 ， 但 是 我 也 不 太 确定 这 里 应 用 工厂 隔离 模式 是 否 合适 。 我 去 跟 Steve 


确认 一 下 oO 


1. 工厂 隔离 模式 的 误 用 
Dianne 叫 了 Steve 过 来 一 起 看 代码 以 确认 David 工 厂 隔离 模式 的 使 用 是 否 正 确 。 

STEVE: 有 什么 事 吗 ? 

DIANNE: 帮 我 看 看 这 个 类 的 实现 。David 在 这 里 使 用 了 工厂 隔离 模式 ， 但 是 我 沉 
得 可 能 不 太 合适 。 

STEVE: 嗯 , 的 确 不 合适 ,我 知道 问题 是 什么 。 David, 你 用 的 是 ADO.NET, 对 吧 ? 
我 们 看 看 你 的 工厂 类 的 实现 代码 。 
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David 打 开 了 文件 。Dianne 和 Steve 看 到 的 源 代 码 如 代码 清单 11-6 所 示 。 
代码 清单 11-6 使 用 工厂 隔离 的 日 标 是 管理 数据 库 连 接 的 生命 周期 


public class AdoNetConnectionIsolationFactory : IConnectionIsolationFactory 








{ 
private readonly IApplicationSettings applicationSettings; 
private readonly DbProviderFactory dbProviderFactory; 
public AdoNetConnectionIsolationFactory(IApplicationSettings applicationSettings) 
{ 
this.applicationSettings = applicationSettings; 
this.dbProviderFactory = DbProviderFactories 
.GetFactory(applicationSettings.GetValue("DatabaseProviderName")); 
} 
public void With(Action<IDbConnection> action) 
{ 
using(var connection = dbProviderFactory.CreateConnection()) 
{ 
connection.ConnectionString = applicationSettings 
.GetValue("ProsewareConnectionString"); 
connection.OpenQO; 
action(connection); 
} 
} 
} 


STEVE: DbProviderFactory 类 的 CreateConnection 方 法 返回 的 是 IDbConnec- 
tion 对 参 。 

DAVID: 别 ， 是 的 。 

DIANNE: 我 明白 问题 所 在 了 。 工 厂 隔 离 模 式 只 适合 在 工厂 生成 对 象 不 确定 实现 
IDisposable 接 口 时 使 用 , 而 IDbConnection 接 口 已 经 实现 了 IDisposable 接 口 ， 所 以 
它 能 保证 所 有 自己 的 实现 类 都 实现 了 公共 的 Dispose 方 法 。 

STEVE: 的 确 。 所 以 你 根本 不 需要 使 用 工厂 隔离 ， 因 为 …… 

DAVID: 因为 我 只 需要 换 成 使 用 Using 语句 块 就 可 以 了 。 

DIANNE: 对 。 

DAVID: 好 的 ， 所 以 这 应 该 只 是 一 个 普通 的 工厂 ? 

DIANNE: 我 不 这 么 认为 。 你 看 这 个 类 的 具体 实现 ， 已 经 很 好 地 对 客户 端 隐藏 了 
DbProviderFactory 类 。 所 以 我 认为 这 里 的 工厂 中 间 层 是 没 必要 的 。 

STEVE: 我 同意 。 

DAVID : 但 是 这 就 意味 着 我 要 在 房间 存储 库 的 实现 中 直接 调用 DbProvider- 
Factory 类 。 这 样 做 不 够 灵活 ， 尤 其 是 DbProviderFactory 类 还 是 静态 的 。 

STEVE: 是 的 ， 所 以 DbProviderFactory 类 最 好 不 要 是 静态 的 。 但 是 房间 存储 库 
的 实现 直接 依赖 ADO.NET， 所 以 静态 的 DbProviderFactory 也 不 算 大 问题 。 引 入 工厂 


这 
这 
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会 让 本 来 只 在 存储 库 实 现 中 操心 的 细节 变 得 公开 了 。 
DAVID: 好 的 ， 有 道理 。 那 么 我 们 可 以 直接 忽略 对 这 个 静态 类 的 依赖 ， 因 为 它 太 通用 
了 ， 对 吧 ? 
DIANNE: 是 的 。 你 可 以 考虑 为 DbProviderFactory 类 引入 接口 ， 然 后 为 其 增加 有 
意义 的 修饰 或 适 配 , 任 何 可 替换 的 行为 都 应 该 从 更 高 层次 的 TRoomRepository 接 口 实现 
中 注入 % 
DAVID: 我 明白 了 。 让 我 重 构 一 下 ， 然 后 再 让 你 们 看 看 。 
2. 重 构 
David 对 房间 存储 库 进 行 了 重 构 ， 重 构 的 结果 如 代码 清单 11-7 所 示 。 他 再 把 Dianne 和 Steve 叫 
来 以 听取 他 们 的 建议 和 意见 。 


代码 清单 11-7 重 构 后 的 房间 存储 库 直 接 使 用 了 DbProviderFactory 


public class AdoNetRoomRepository : IRoomRepository 


{ 

















private readonly IApplicationSettings applicationSettings; 

private readonly DbProviderFactory databaseFactory; 

public AdoNetRoomRepository(IApplicationSettings applicationSettings, 
DbProviderFactory databaseFactory) 


{ 
Contract.Requires<ArgumentNullException>(applicationSettings != null); 
Contract.Requires<ArgumentNullException>(databaseFactory != null); 
this.applicationSettings = applicationSettings; 
this.databaseFactory = databaseFactory; 

} 


public void CreateRoom(string name) 
{ 
using(var connection = databaseFactory.CreateConnection()) 
{ 
connection.ConnectionString = 
applicationSettings.GetValue("ProsewareConnectionString"); 
connection.OpenQO; 


using(var transaction = connection.BeginTransaction()) 


{ 


var command = connection.CreateCommand(); 
command.CommandText = "dbo.create_room"; 
command.CommandType = CommandType.StoredProcedure; 
command.Transaction = transaction; 

var parameter = Command.CreateParameter() ; 
parameter .DbType = DbType.String; 
parameter.ParameterName = "name"; 

parameter.Value = name; 
command.Parameters.Add(parameter); 


Command .ExecuteNonQuery() ; 
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DAVID: 我 做 了 些 改 动 。 我 把 原来 连接 工厂 类 的 代码 继承 到 存储 库 类 中 。 我 也 不 想 
随意 使 用 静态 的 DbProviderFactories 类 。DbProviderFactory 类 至 少 应 该 是 能 够 提 
供 扩展 点 的 抽象 类 。 这 样 做 ,我们 就 可 以 使 用 场景 的 依赖 注入 方式 ,只 是 注入 的 是 抽象 
类 ， 而 不 是 接口 。 

DIANNE: 很 好 ， 我 觉得 你 改 得 很 好 。 

STEVE: 你 能 给 我 看 看 注册 配置 DbProviderFactory 类 的 控制 反 转 容器 吗 ? 我 想 
知道 你 的 注册 过 程 。 

David 给 Steve 和 Dianne 展 示 了 使 用 Unity 的 注册 代码 ， 如 代码 清单 11-8 所 示 。 


代码 清单 11-8 ”DbProviderFactory 的 统一 控制 反 转 ( IoC ) 注册 


container.RegisterType<DbProviderFactory>(new InjectionFactory(c => 
DbProviderFactories.GetFactory( 
c.Resolve<IApplicationSettings>©O) .GetValue("DatabaseProviderName")))); 


STEVE: 担 好 。 我 原 以 为 因为 涉及 静态 类 会 让 注册 显得 不 自然 , 但 我 认为 你 做 得 很 
好 ， 已 经 把 它 从 存储 库 的 实现 中 抽象 出 来 了 。 

DIANNE: 我 觉得 可 以 提交 代码 了 ， 你 认为 呢 ，Steve? 

STEVE: 嗯 ， 提 交 吧 。 这 样 我 们 第 一 个 故事 的 编码 工作 就 完成 了 。 
David 提 交 了 代码 后 ， 团 队 就 开始 了 下 一 个 故事 的 开发 。 
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第 二 天 ，David 完 成 了 第 二 个 故事 ， 可 以 查看 所 有 已 经 创建 房间 的 列表 。 在 提交 代码 前 ， 他 
又 叫 了 Dianne 来 做 评审 。 
DAVID: 我 修改 了 RoomController， 这 样 它 就 可 以 读 取 房间 列表 并 在 一 个 页 面 上 
显示 房间 列表 了 。 
DIANNE: 好 的 ， 我 们 就 从 发 生变 更 的 地 方 开始 。 给 我 看 看 你 对 RoomContro11er 
的 修改 。 
David 给 Dianne 展 示 的 代码 如 代码 清单 11-9 所 示 。 为 了 让 代码 片段 更 好 地 表达 当前 讲解 的 重 
点 ， 下 面 示例 中 略 去 了 房间 的 创建 动作 代码 。 


代码 清单 11-9 “RoomContro11er 有 一 个 用 于 列 出 房间 的 新 动作 


public class RoomController : Controller 


{ 





private readonly IRoomRepository roomRepository; 
private readonly IRoomViewModelMapper viewMode1Mapper ; 
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public RoomController(IRoomRepository roomRepository, IRoomViewModelMapper mapper) 
{ 
Contract.Requires<ArgumentNullException>(roomRepository != null); 
Contract.Requires<ArgumentNullException>(mapper != null); 


this.roomRepository = roomRepository; 
this.viewModelMapper = mapper; 


} 
[HttpGet] 
public ActionResult List() 
{ 
var roomListViewModel = new RoomListViewModel(); 
var allRoomRecords = roomRepository.GetAllRooms OO); 
foreach(var roomRecord in allRoomRecords) 
{ 
roomListViewModel .Rooms 
.Add(viewModelMapper .MapRoomRecordToRoomViewModel(roomRecord)); 
} 
return View(roomListViewModel); 
} 


DAVID: 这 里 引入 了 一 个 新 的 构造 函数 参数 : 一 个 映射 器 ， 也 相应 地 增加 了 代码 
契约 来 保证 它 不 为 空 ， 另 外 也 为 它 编 写 了 对 应 的 单元 测试 。 

DIANNE: 很 好 , 但 我 觉得 还 可 以 对 一 个 地 方 进行 改动 。 跟 我 讲 一 遍 你 的 List 方 法 ， 
我 会 让 你 知道 我 们 还 可 以 简化 这 个 类 。 

DAVID: List 方 法 实际 上 有 两 个 部 分 。 第 一 ， 房 间 存 储 库 会 查询 以 获取 所 有 房间 
记录 。 但 是 ,这 些 房间 记录 只 是 数据 模型 ,不 是 视图 模型 ， 所 以 我 引入 了 映射 器 来 完成 
类 间 的 转换 。 这 个 工作 会 委托 给 映射 器 接口 。 在 房间 模型 数据 转换 为 RoomViewMode1 
类 的 对 象 后 ， 我 们 就 可 以 把 它们 传递 给 视图 以 显示 房间 列表 。 

DIANNE: 我 认为 你 的 抽象 有 个 漏洞 。IRoomRepository 接 口 返回 的 RoomRecord 
类 属于 更 下 面 的 数据 存储 层 。 我 不 确定 是 否 应 该 把 它 直接 抛 出 到 控制 器 中 。 你 引入 映射 
器 的 目的 正 是 为 了 把 数据 层 类 型 转换 为 视图 数据 类 型 。 

DAVID: 但 是 我 们 还 有 其 他 的 方式 吗 ? 我 只 能 得 到 RoomRecord 实 例 ， 但 是 我 也 需 
要 返回 RoomViewMode1 类 的 对 象 。 

DIANNE: 嗯 。 但 是 控制 器 不 应 该 知道 RoomRecord 类 的 存在 ， 也 不 应 该 知道 类 的 
映射 过 程 。 让 控制 器 既 不 依赖 IRoomRepository 接 口 也 不 依赖 IRoomViewMode1Mapper 
接口 ， 而 是 依赖 一 个 新 的 接口 ， 怎 么 样 ? 我 们 可 以 把 这 个 新 接口 命名 为 
IRoomViewMode1Service。 它 可 以 让 控制 器 不 知道 RoomRecord 的 存在 。 这 个 新 服务 的 
实现 能 够 使 用 房间 存储 库 和 映射 器 来 返回 控制 唯一 了 解 的 RoomViewMode1 类 的 实例 。 
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DAVID: 我 明白 。 但是，IRoomRepository 接 口中 已 有 的 CreateRoom 方 法 调用 怎 
么 办 ? 没有 存储 库 ， 控 制 器 没 办 法 调用 这 个 方法 。 

DIANNE: 问 得 好 。 这 里 我 建议 你 做 接口 分 离 。 可 以 把 ITRoomViewMode1Service 
接口 分 离 为 ITRoomViewMode1Reader 和 IRoomViewMode1Writer 两 个 接口 。 这 样 可 以 给 
我 们 以 后 变更 实现 的 读 和 写 都 提供 独立 的 扩展 点 

DAVID: 好 的 ， 这 样 分 离 后 ， 我 的 单元 测 试 代码 也 要 做 很 多 改动 。 看 来 只 有 等 
构 完 后 再 请 教 你 了 

DIANNE: 这 会 影 响 我 们 的 冲刺 目标 的 完成 吗 ? 需要 为 交付 期 限 做 折 中 方案 吗 ? 

DAVID: 不 需要 ， 重 构 工作 量 不 大 。 我 应 该 能 在 一 两 个 小 时 内 搞定 。 

DIANNE: 很 好 。 

David 开 始 修复 Dianne 指 出 的 问题 。 
重 构 
David 花 了 几 个 小 时 完成 了 Dianne 建 议 的 改动 。 然 后 他 叫 Dianne 对 重 构 后 的 代码 再 做 一 次 检查 。 

DAVID: 这 是 我 重 构 后 的 控制 器 。 你 看 看 还 有 什么 

代码 清单 11-10 展 示 了 重 构 后 的 新 控制 器 。 


代码 清单 11-10 ”控制 硕 根 据 读 取 和 写 人 接口 进行 了 重 构 


public class RoomController : Controller 
{ 
private readonly IRoomViewModelReader reader; 
private readonly IRoomViewModelWriter writer; 
public RoomController(IRoomViewModelReader reader, IRoomViewModelWriter writer) 





{ 
Contract.Requires<ArgumentNullException>(reader != null); 
Contract.Requires<ArgumentNullException>(writer != null); 
this.reader = reader; 
this.writer = writer; 

} 

[HttpGet] 

public ActionResult List() 

{ 
var roomListViewModel = new RoomListViewModel(reader.GetAllRooms()); 
return ViewCroomListViewMode1) ; 

} 

[HttpGet] 

public ActionResult Create() 

{ 
return View(new RoomViewModel()); 

} 

[HttpPost] 


public ActionResult Create(RoomViewModel model) 
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ActionResult result; 


if(ModelState.IsValid) 
{ 


writer.CreateRoom(model .Name); 


result = RedirectToAction("List"); 
} 


else 


{ 


result = View("Create", model); 


} 


return result; 


DIANNE: 现在 你 已 经 完全 别 除 了 对 映射 器 的 依赖 。 注 入 IRoomViewModelReader 
和 IRoomViewMode1Writer 两 个 接口 意味 着 我 们 后 面 能 够 分 别 改 动 读 和 写 的 实现 ,可 以 
防止 我 们 后 面 更 改 到 CQRS 架 构 。 

DAVID: CQRS 是 什么 来 着 ， 你 能 给 个 提示 吗 ? 

DIANNE: CQRS 即 命令 查询 责任 分 离 。 按 照 这 种 模式 ， 你 的 应 用 程序 中 的 命令 和 
查询 是 非 对 称 的 。 现 在 这 个 项 目 里 ， 我 们 可 能 会 向 事务 存储 写 入 数据 但 却 从 非 事 务 型 
的 文档 存储 中 读 取 数 据 。 我 认为 Steve 已 经 在 为 当前 架构 不 能 很 好 适应 扩展 的 情况 准备 

能 的 新 架构 了 ， 我 们 都 在 这 样 猜想 。 

DAVID: 我 记 起 来 了 ,命令 查询 责任 分 离 听 起 来 对 于 我 们 的 场景 手 合 适 的 。 那 我 们 

开始 看 看 IRoomViewMode1Reader 和 IRoomViewMode1Writer 这 两 个 接口 的 实现 吧 ? 


Dianne 点 点 头 ，David 打 开 包 含 实 现 类 的 文件 ， 内 容 如 代码 清单 11-11 所 示 。 


代码 清单 11-11 ”一 个 更 接近 于 原始 控制 硕 代 码 的 服务 实现 


public class RepositoryRoomViewModelService : IRoomViewModelReader, IRoomViewModelWriter 
{ 
private readonly IRoomRepository repository; 
private readonly IRoomViewModelMapper mapper ; 
public RepositoryRoomViewModelService(IRoomRepository repository, 
IRoomViewMode lMapper mapper) 


{ 
Contract.Requires<ArgumentNullException>(repository != null); 
Contract.Requires<ArgumentNullException>(mapper != null); 
this.repository = repository; 
this.mapper = mapper; 

} 


public IEnumerab le<RoomVvViewMode1> GetAllRooms() 
{ 


var allRooms = new List<RoomViewModel>(); 


11.4 “我 想 查 看 发 送 到 一 个 房间 内 的 消息 ” 307 


var allRoomRecords = repository.GetAllRooms(); 
foreach(var roomRecord in allRoomRecords) 


: allRooms .Add(mapper.MapRoomRecordToRoomViewModel (roomRecord)); 
ee allRooms; 

} 

public void CreateRoom(string roomName) 

repository.CreateRoomCroomName ) ; 

} 


DAVID: 我 决定 在 一 个 类 中 同时 实现 两 个 接口 , 因为 它们 都 依赖 IRoomRepository 
接口 。 但是, 我 认为 它 和 原 有 的 控制 器 类 实现 很 接近 ， 那么 我 们 这 样 重 构 后 又 得 到 什么 
好 处 了 呢 ? 

DAINNE: 最 大 的 好 处 是 ， 现 在 的 控制 器 的 主要 职责 更 加 清晰 了 。 它 现在 不 再 负责 
从 记录 到 视图 模型 的 转换 ， 而 是 专心 做 校 验 。 不 再 需要 知道 RoomRecord 类 的 控制 器 比 
原来 的 好 很 多 。 

DAVID: 是 的 ， 可 是 我 认为 是 不 是 做 得 有 点 过 了 ， 你 党 得 呢 ? 

DIANNE: 它 并 没有 真正 违背 单一 职责 原则 。 如 果 我 们 不 使 用 存储 库 ， 那 么 我 们 也 
不 需要 映射 器 。 这 种 变化 会 影响 到 架构 ， 控 制 器 不 应 该 担心 这 样 的 改变 。 


然后 ，David 和 Dianne 都 同意 可 以 提交 这 个 故事 的 实现 了 。 


11.4 “我 想 查 看 发 送 到 一 个 房间 内 的 消息 ” 


通过 结对 编程 ，Dianne 和 David 在 一 起 实现 下 一 个 故事 。 在 Dianne 编 写 代 码 时 ，David 在 旁边 
阅读 并 提出 建议 。 


注意 ”结对 编程 (pair programming ) 是 名 为 极限 编程 (Extreme Programming，XP ) 的 敏捷 软 
件 开发 方法 中 一 个 很 常见 的 实践 活动 ， 它 是 指 两 个 开发 人 员 一 起 完成 同一 个 指定 的 功能 。 当 
结对 一 方 编写 代码 时 ， 另 一 方 能 考虑 正在 实现 的 方法 、 类 或 单元 测试 是 否 还 有 更 好 的 方式 。 


DIANNE: 我 们 从 控制 器 开始 吧 ? 

DAVID: 好 的 ， 从 这 里 开始 应 该 比较 好 。 

DIANNE: 现在 我 们 需要 为 查看 房间 内 的 信息 增加 一 个 新 的 HttpGet 处 理 器 。 我 
们 叫 它 什么 呢 ? 

DAVID: 就 叫 GetMessages 吧 ， 怎 么 样 ? 

DIANNE: 听 起 来 很 好 ， 但 ASPNET MVC 模 式 使 用 控制 器 名 称 和 方法 名 称 来 构造 
请 求 的 URL。 
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DAVID: 是 啊 ， 我 忘记 这 个 了 。 那 就 叫 作 Messages 吧 ? 作为 Roomntro11er 的 一 部 
分 后 ，URL 看 起 来 会 是 /Room/Messages 这 样子 。 

DIANNE: 好 , 这 个 名 称 可 以 。 我 们 还 需要 一 个 参数 来 表示 要 查看 哪个 房间 的 消息 。 

DAVID: 我 们 有 房间 标识 ， 它 能 唯一 表示 一 个 房间 。 我 们 就 用 它 如 何 ? 

DIANNE: 有 是 个 整 型 还 是 长 整 型 ? 

DAVID: 我 觉得 整 型 就 够 了 。 

DIANNE: 我 们 也 需要 为 这 个 视图 增加 相应 的 视图 模型 。 按 照 你 现在 一 直 在 用 的 命 
名 规则 ， 就 叫 它 MessageListViewMode1， 怎 么 样 ? 

DAVID: 可 以 。 我 们 只 要 把 MessageListViewMode1 类 实例 传 给 控制 器 的 View 方 法 
就 可 以 得 到 一 个 ViewResult 类 的 返回 。 

DIANNE: IRoomViewMode1Reader 会 需要 一 个 新 的 方法 来 查询 房间 内 的 消息 。 

DAVID: 我 觉得 叫 它 GetRoomMessages 就 好 ， 它 也 有 个 表示 房间 标识 的 参数 。 

DIANNE: 我 会 先 在 接口 中 定义 ， 然 后 在 实现 类 中 提供 一 个 占 位 实现 以 便 我 们 后 面 
决定 控制 器 怎么 做 改动 。 


Dianne 创 建 的 方法 如 代码 清单 11-12 所 示 。 
代码 清单 11-12 ” Messages 方法 按 ID 检索 所 有 与 房间 相关 联 的 消息 


[HttpGet] 
public ActionResult Messages(int roomID) 


{ 








var messageListViewModel = new MessagelListViewModel(reader.CGetRoomMessages(roomID)); 


return View(messageListViewModel); 


DIANNE: 看 起 来 不 错 。 现在 我 们 可 以 实现 IRoomViewMode1Reader 接 口中 的 Get- 
RoomMessages 方 法 了 。 

DAVID: 好 的 ， 现 在 的 实现 只 使 用 了 IRoomRepository 接 口 。 我 认为 我 们 应 该 新 
增 一 个 IMessageRepository 接 口 以 便 能 获取 消息 。 

DIANNE: 同意 。 我 们 只 需要 从 构造 函数 注入 它 即 可 ， 就 像 其 他 依赖 一 样 。 

DAVID: 当 我 们 有 了 消息 存储 库 后 , 我 们 需要 请 求 它 来 根据 房间 标识 获取 消息 ， 然 
后 把 消息 传递 给 映射 器 。 

DIANNE: 那么 这 个 新 的 映射 器 负责 将 存储 库 记 录 转 换 为 视图 模型 ， 这样 控制 器 才 可 
以 使 用 ， 对 吧 ? 现在 看 ， 好 像 只 有 一 个 IRoomViewMode1Mapper 接 口 可 用 。 狐 似 应 该 增加 
一 个 新 的 IMessageViewMode1Mapper 接 口 了 。 我 们 能 把 这 个 接口 命名 定义 得 更 加 通用 吗 ? 

DAVID: IViewMode1Mapper 这 个 名 称 怎么 样 ? 这 个 名 称 表 明 它 可 以 将 所 有 记录 转 
换 为 相应 的 视图 模型 。 

DIANNE: 代码 写成 下 面 这 样 ， 你 看 怎么 样 ? 


Dianne 给 David 展 示 的 代码 如 代码 清单 11-13 所 示 。 
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代码 清单 11-13 ”将 记录 映射 到 ViewMode1 的 类 现在 包含 一 个 用 于 检索 房间 消息 的 方法 


public class RepositoryRoomViewModelService : IRoomViewModelReader, IRoomViewModelWriter 
{ 
private readonly IRoomRepository roomRepository; 
private readonly IMessageRepository messageRepository; 
private readonly IViewModelMapper mapper; 
public RepositoryRoomViewModelService(IRoomRepository roomRepository, 
IMessageRepository messageRepository, IViewModelMapper mapper) 


{ 
Contract.Requires<ArgumentNullException>(roomRepository != null); 
Contract.Requires<ArgumentNullException>(messageRepository != null); 
Contract.Requires<ArgumentNullException>(mapper != null); 
this.roomRepository = roomRepository; 
this.messageRepository = messageRepository; 
this.mapper = mapper; 

} 

public IEnumerable<MessageViewModel> GetRoomMessages(int roomID) 

{ 
var roomMessages = new List<MessageViewMode1>(D) ; 
var roomMessageRecords = messageRepository.GetMessagesForRoomID(roomID); 
foreach(var messageRecord in roomMessageRecords) 
{ 

roomMessages.Add(mapper .MapMessageRecordToMessageViewModel (messageRecord)); 

} 
return roomMessages; 

} 


DAVID: 嗯 ， 这 样 写 可 以 。 


David 和 Dianne 然 后 接着 实现 了 消息 存储 库 的 GetMessageForRoomID 方 法 ， 该 方法 从 
Microsoft SQL Server 数 据 库 中 加 载 消 息 。 提 交 所 有 代码 后 ， 他 们 开始 开发 下 一 个 用 户 故 事 。 


11.5 “我 想 给 房间 内 的 其 他 成 员 发 送 纯 文本 消息 ” 
实现 最 后 一 个 故事 时 ，David 和 Dianne 交 换 了 位 置 ，David 写 代码 ，Dianne 提 建议 。 
De A 
DIANNE: 一 定 程度 上 是 的 。 但 是 记 住 ， 这 个 故事 的 一 个 需求 是 说 所 有 发 送 消息 的 
动作 是 并 行 发 生 的 。 
DAVID: 噢 。 所 以 不 能 做 全 页 完全 回 发 。 
DIANNE: 嗯 ， 不 可 以 。 用 户 界 面 会 通过 一 个 AJAX 请 求 发 送 消息 数据 。 





注意 ”一些 术语 定义 : AJAX (Asynchronous JavaScript and XML ，AJAX ) 指 异 步 的 Java 
Script 和 XML。XML ( Extensible Markup Language，XML ) 是 指 可 扩展 的 标记 语言 。AJAJ 
(Asynchronous JavaScript and JSON，AJAJ ) 是 指 异 步 的 JavaScript 和 JSON。JSON ( JavaScript 
Object Notation，JSON ) 是 指 JavaScript 对 象 标 记 法 。 
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DAVID: 等 等 ， 你 是 说 AJAJ， 对 吗 ? 
DIANNE: 我 党 得 我 是 要 说 AJAJI 
DAVID: 这 样 能 让 控制 器 行为 有 何不 同 ? 
DIANNE: 实际 上 ， 有 两 处 不 同 。 当 ModelState.IsValid 必 性 为 真 时 ， 我们 应 该 使 
用 IRoomViewMode1Writer 接 口 来 保存 消息 。 但 我 们 应 该 以 JsonResult 类 返回 视图 模型 。 
DAVID: 那么 如 果 模 型 状态 无 效 时 ， 我们 要 做 什么 呢 ? 
DIANNE: 无 效 时 我 们 应 该 返回 一 个 带 有 HTTP 440 错 误 的 HttpStatusCodeResult 
类 值 。 
DAVID: 这 是 一 个 客户 端 错误 响应 代码 吗 ? 
DIANNE: 是 的 ，404 是 指 错 误 请 求 的 响应 。 
David 给 Dianne 展 示 了 他 编写 的 代码 ， 如 代码 清单 11-14 所 示 。 
代码 清单 11-14 RoomController 类 上 的 AddMessage 方 法 


[HttpPost] 
public ActionResult AddMessage(MessageViewModel messageViewModel) 
{ 


ActionResult result; 


if(ModelState.IsValid) 
{ 


writer .AddMessage (messageViewModel); 


result = Json(messageViewModel); 
} 
else 
{ 
result = new HttpStatusCodeResult(400); 
} 


return result; 


DAVID: IRoomViewMode1Writer 接 口 实现 类 中 的 AddMessage 方 法 会 是 什么 样子 呢 ? 
DIANNE: 我 想 我 们 可 以 使 用 与 TRoomViewMode1Writer 接 口 实 现 一 样 的 模式 。 这 
部 分 代码 并 不 在 乎 是 否 被 异步 调用 ， 所 以 不 需要 改变 我 们 目前 使 用 的 模式 。 
David 按 照 IRoomViewMode1wWriter 接 口 的 CreateRoom 方 法 中 的 模式 编写 了 AddMessage 方 
法 ， 如 代码 清单 11-15 所 示 。 


代码 清单 11-15 ”RoomViewMode1Writer 类 上 的 AddMessage 方 法 


public void AddMessage(MessageViewModel messageViewModel) 


{ 











var messageRecord = mapper.MapMessageViewModelToMessageRecord(messageViewModel); 
messageRepository.AddMessageToRoom(messageRecord.RoomID, messageRecord.AuthorNanme, 
messageRecord.Text); 


} 
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至 此 ， 加 上 通过 ADO.NET 从 Microsoft SQL Server 获 取消 息 记录 的 存储 库 方法 后 ， 最 后 一 个 
故事 也 完成 了 开发 工作 。 

现在 David 和 Dianne 已 经 完成 了 当前 冲刺 的 所 有 故事 ， 也 刚好 赶 上 了 冲刺 演示 会 议 。 
11.6 ”演示 会 议 

星期 五 , 团队 安排 了 冲刺 演示 会 议 来 为 客户 展示 目前 的 开发 进度 。 完 成 的 故事 被 集成 在 了 一 
起 , 并 且 要 逐个 展示 每 个 故事 的 功能 。 团队 希望 客户 可 以 基于 此 次 演示 提供 反馈 ,以 确定 是 否 改 
变 产 品 的 开发 方向 。 

冲刺 演示 会 议 有 很 多 好 处 。 第 一 ,， 它 能 让 团队 确定 开发 工作 始终 是 满足 客户 当前 需求 的 。 演 
示 也 能 激励 团队 成 员 总 是 提供 最 好 的 产 出 , 因为 他 们 必须 足够 目 信 地 向 客户 展示 当前 产品 的 开发 
状态 。 客户 也 能 从 冲刺 演示 会 议 中 获取 恨 多 , 因为 他 们 在 产品 早期 就 能 定期 地 看 到 产品 上 实 实在 
在 的 进展 。 如 果 客 户 想 要 改变 产品 的 工作 方式 , 演示 会 议 就 是 提出 建议 和 音 见 的 最 佳 场合 。 演示 
会 议 的 输出 是 改变 和 重新 排序 后 的 用 户 故 事 积压 工作 , 而 且 软 件 产品 可 以 从 下 一 个 冲刺 起 立即 根 
据 客户 需求 改变 开发 方 癌 。 
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在 演示 会 议 这 天 , 整个 团队 和 一 个 客户 代表 都 齐 聚 在 会 议 室 。 团 队 人 简单 地 讨论 了 当前 训 刺 的 
进展 情况 ， 并 准备 为 客户 展示 当前 产品 的 开发 状态 。 

关键 时 刻 , 不幸 的 事情 发 生 了 , 会 议 室 的 投影 仪 工作 不 太 正 稼 。 这 让 演示 推迟 了 几 分钟 ,， 直 
到 一 个 技术 人 员 解 决 了 投影 仪 的 问题 。 投 影 仪 重新 启动 后 , 团队 发 现 屏 幕 分 辩 率 比 他 们 的 开发 时 
低 好 多 。 这 样 用 户 界面 的 表现 差 了 很 多 ， 客 户 都 很 难 分辩 布 局 到 底 是 在 哪个 页 面 上 。 

团队 向 用 户 道歉 ,客户 也 似乎 表示 理解 , 但 是 他 还 是 抱怨 了 展示 的 应 用 程序 并 没有 达到 他 们 
想 要 的 标准 。 在 反复 调整 了 一 些 显示 设置 后 , 应 用 程序 看 起 来 好 了 点 ,但 是 依然 达 不 到 开发 环境 
中 展示 的 水 平 。 

队 逐 个 展示 了 这 个 冲刺 已 经 实现 的 四 个 故事 , 然后 询问 客户 是 否 有 问题 或 建议 。 客户 的 评 
价 整体 上 是 可 以 接受 的 : 尽管 应 用 程序 还 没 做 多 少 事情 , 但 是 一 些 核心 功能 在 很 早期 就 已 经 就 绪 
可 用 了 。 

Petra 建 议 接 下 来 的 任务 应 该 包括 格式 化 消息 的 发 送 。 她 也 提 到 了 David 有 关内 容 过 滤 大 的 想 
法 。 看 起 来 客户 对 这 个 主意 很 感 兴趣 ， 并 要 求 团 队 把 它 作为 下 一 个 冲刺 的 高 优先 级 工作 项 。 

会 议 结束 后 ， 客 户 先行 离开 了 ， 整 个 团队 依然 留 在 会 议 室 ， 准 备 开始 他 们 的 冲刺 回顾 会 议 。 


11.7 ”回顾 会 议 


冲刺 结束 时 , 所 有 团队 成 员 都 聚 在 一 起 讨论 本 周 的 工作 进展 ,他 们 都 要 讨论 和 回答 以 下 问题 。 
口 什么 做 得 比较 好 ? 
口 什么 做 得 不 太 好 ? 
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口 冲刺 中 有 没有 需要 保持 的 新 东西 ? 

口 冲刺 中 有 没有 发 现任 何 意 料 之 外 的 事情 ? 

冲刺 会 议 的 目标 是 生成 一 个 可 执行 的 、 排 好 序 的 工作 项 列表 ， 然 后 在 会 后 实施 。 按 照 惯例 ， 
会 议 的 输出 不 是 为 了 生成 无 法 切实 执行 的 结论 。 


11.7.1 什么 做 得 比较 好 


会 议 室 中 , 所 有 团队 成 员 逐 个 回答 上 面 问题 列表 中 的 每 个 问题 。 他 们 先 从 当前 冲刺 中 做 得 比 
较 好 的 事情 开始 。 

STEVE: 那么 ， 大 家 认为 第 一 个 冲刺 中 做 得 比较 好 的 都 有 什么 ? 

PETRA: 我 认为 演示 不 错 。 尽 管 没有 完全 达到 客户 的 期 望 , 但 是 效果 依然 是 积极 的 。 

TOM: 我 完全 同意 。 我 认为 客户 也 清楚 地 知道 这 还 不 是 最 终 的 产品 ， 甚 至 不 是 第 一 
个 要 发 布 的 版 本 ， 但 是 演示 在 短 短 的 时 间 里 让 客户 知道 了 已 完成 工作 的 实 实在 在 的 价值 。 

DIANNE: 他 们 很 积极 地 提供 了 有 建设 性 的 反馈 ， 也 改变 了 我 们 的 开发 方向 ， 即 使 
在 一 个 非常 早 的 阶段 。 

PETRA: 是 的 ， 演 示 后 我 们 还 提 到 了 另 一 个 有 价值 的 想法 。David， 你 的 内 容 过 滤 
器 的 主意 得 到 了 用 户 很 好 的 响应 , 他们 提高 了 它 的 优先 级 ， 因 为 我 们 需要 在 下 一 个 冲刺 
中 开工 实现 它 。 

DAVID: 我 很 高 兴 客 户 对 我 们 正在 做 的 事情 表现 得 很 热情 。 我 们 只 需要 管理 一 下 
他 们 的 期 望 值 : 我 不 想 他 们 过 分 表扬 我 们 现 有 的 工作 成 果 。 

STEVE: 还 有 其 他 什么 做 得 比较 好 的 吗 ? 

DIANNE: 我 认为 代码 写 得 不 错 。 尽 管 现在 代码 量 不 大 ,但 它们 肯定 为 后 续 工 作 提 
供 了 一 个 很 好 的 基础 。 

DAVID: 我 需要 给 Dianne 和 Steve 说 声 谢谢 ， 在 和 他 们 协作 开发 的 过 程 中 ， 我 学 到 
了 很 多 。 如 果 没 有 他 们 的 指导 ， 现 在 的 代码 中 很 可 能 已 经 包含 了 一 些 明 显 的 技术 债务 。 

STEVE: 好 的 ， 我 会 记录 这 些 优 点 。 还 有 其 他 的 吗 ? 
会 议 室 开始 变 得 安静 了 ， 所 以 Steve 在 白板 上 记 下 了 以 下 几 点 ， 并 开始 准备 讨论 下 一 个 问题 。 
口 演示 不 错 ， 即 使 在 这 个 阶段 没 多 少 要 展示 的 东西 。 
口 客户 参加 了 演示 会 议 并 且 提 供 了 很 好 的 反馈 。 
口 代码 目前 看 还 不 错 。 


11.7.2 ”什么 做 得 不 太 好 
团队 要 回答 的 下 一 个 问题 是 ， 这 个 冲刺 中 哪些 做 得 不 太 好 。 


STEVE: 这 个 问题 我 们 要 实事 求 是 地 回答 : 这 个 冲刺 中 什么 做 得 不 太 好 ? 
TOM: 我 觉得 这 个 冲刺 我 没有 忙 起 来 。 我 发 现 这 个 阶段 我 并 没有 很 多 可 以 做 出 贡 
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献 的 工作 。 只 有 很 少 的 东西 可 以 测试 ， 而 且 反 复 来 了 好 多 次 。 

PETRA: 好 的 ， 这 个 反馈 很 有 价值 。 那 么 原因 是 什么 呢 ? 

STEVE: 我 认为 这 是 因为 David 是 为 唯一 实现 故事 的 开发 人 员 ， 当 时 Dianne 和 我 正 
在 为 另外 一 个 项 目 准备 一 些 架 构 的 设计 。 

PETRA: 那 这 个 问题 还 一 直 有 吗 ， 或 者 说 我 们 能 解决 它 吗 ? 

DIANNE: 这 个 要 记录 在 “有 待 改 进 ” 的 事项 列表 中 ,但 是 Steve 和 我 打算 接 下 来 在 
Proseware 项 目 中 要 更 像 一 个 猪 的 角色 ， 而 不 是 鸡 的 角色 。 

TOM: 能 告诉 我 你 的 确切 意思 吗 ? 

STEVE: 大 体 上 讲 ， 我 们 虽然 对 Proseware 项 目 有 贡献 ， 但 是 并 没有 完全 投入 。 前 
面 一 段 时 间 我 们 被 要 求 做 另外 一 个 项 目的 维护 工作 。 

DIANNE: 的 确 是 这 样 的 。 我 们 会 在 接 下 来 的 冲刺 中 和 David 一 起 实现 用 户 故 事 ， 
这 样 就 能 给 你 交付 持续 可 测 的 功能 ， 而 不 是 比较 凌乱 的 交付 。 

TOM: 这 样 振 好 。 

STEVE: 还 有 其 他 什么 做 得 不 好 的 吗 ? 

PETRA: 显然 ， 演 示 会 议 开 始 时 的 投影 仪 问 题 可 不 大 好 。 

DAVID: 是 啊 ,， 我 真 不 知道 投影 仪 哪里 出 问题 了 ! 当时 党 得 很 乾 论 ， 不 过 我 想 自己 
恢复 得 还 算 比较 好 了 。 

DIANNE: 是 啊 ， 我 们 补救 得 还 不 错 。 但 我 们 需要 防止 再 犯 这 样 的 错误 。 

STEVE: 我 认为 这 个 问题 的 根本 原因 就 是 缺乏 足够 的 准备 时 间 。 我 们 需要 更 早 更 频 
繁 地 在 所 有 可 能 的 环境 中 集成 测试 ! 以 后 , 我 们 需要 在 演示 前 花 半 个 小 时 在 会 议 室 用 投 
影 仪 预演 我 们 展示 的 东西 。 客户 不 会 在 意 一 次 这 样 的 错误 , 但 是 总 是 犯 同样 的 错误 就 不 
可 以 接受 了 。 

Steve 又 在 白板 上 添加 了 几 个 记录 。 
口 这 个 冲刺 中 测试 没有 足够 的 可 测试 内 容 。 
口 演示 差点 因为 环境 问题 搞 硬 。 

STEVE: 还 有 其 他 的 吗 ? 

所 有 团队 成 员 都 插播 头 表示 没有 ，Steve 决 定 开始 讨论 下 一 个 问题 。 


11.7.3 ”什么 需要 改变 


敏捷 流程 非常 灵活 ,团队 应 该 借 着 回顾 会 议 的 机 会 来 说 出 流程 哪些 部 分 适合 他 们 ， 哪些 部 分 
阻碍 他 们 。 为 改进 流程 、 工 作 环 境 或 其 他 实践 而 制定 可 执行 的 工作 计划 是 改进 团队 工作 的 一 个 很 
好 的 办 法 。 

STEVE: 现在 , 我 们 已 经 得 出 一 些 我 们 没 做 好 的 事情 上 的 改进 事项 。 第 一 ,从 下 一 

个 冲刺 开始 ，Dianne 和 我 自己 将 投入 更 多 的 精力 到 项 目 中 来 。 第 二 ， 我 们 需要 再 拿 出 半 

个 小 时 在 会 议 室 用 投影 仪 进 行 预演 。 还 有 其 他 吗 ? 
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会 议 室 很 安静 。 

STEVE: 那 好 吧 ， 我 来 问 。 Cr 会 议 有 什么 问题 吗 ? 

TOM: 实际 上 上， 是 有 问题 的 。 这 个 冲刺 因为 堵车 导致 我 缺席 了 两 次 站 立会 议 ， 你 
还 记得 吗 ? 

DIANNE: 我 也 一 样 ， 我 都 忘记 说 这 个 了 。 

STEVE: 那 改 为 早上 九 点 半 会 好 些 吗 ? 

TOM: 咽 ， 会 好 些 。 对 我 来 说 ， 真 的 无 法 保证 早上 九 点 就 能 到 办 公 室 。 

PETRA: 我 会 通知 管理 层 ， 我 们 应 该 实行 弹性 工作 制度 。 

TOM: 谢谢 ， 那 样 最 好 。 

DAVID: 我 认为 我 们 应 该 给 客户 的 演示 间隔 时 间 更 长 点 。 太 频繁 的 话 ， 需 要 客户 每 
周 来 到 我 们 这 里 ， 但 每 次 就 只 能 看 到 不 太 多 的 进展 。 两 周一 次 可 以 解决 这 两 个 问题 ， 你 
们 党 得 呢 ? 

STEVE: 这 个 主意 很 好 , 肯定 可 以 解决 你 说 的 问题 。 可 是 我 认为 演示 是 激励 我 们 交 
付 的 一 个 很 好 的 动力 。 我 依然 想 保 持 每 周 演示 的 频率 ， 那 么 对 客户 的 演示 每 两 周一 次 ， 
我 们 自己 内 部 的 演示 依然 是 每 周一 次 ， 如何? 内 部 演示 只 需要 我 们 团队 自己 参加 , 不 需 
要 管理 层 参 加 。 


PETRA: 我 觉得 这 样 是 可 行 的 。 这样 能 让 我 们 完善 我 们 的 演示 流程 ,同时 也 能 让 客 
一 次 看 到 更 多 的 功能 呈现 。 


David 很 高 兴 他 的 意见 得 到 了 采纳 ，Steve 在 白板 上 再 加 上 了 下 面 儿 点 。 

口 Dianne 和 Steve 需 要 为 交付 用 户 故 事 投入 更 多 的 精力 到 项 目 中 。 

口 给 客户 的 演示 每 两 周一 次 。 

口 内 部 演示 只 需要 团队 人 参加。 

口 正式 演示 前 , 安排 额外 的 半 个 小 时 来 回顾 演示 计划 并 进行 预演 ,以 确定 一 切 都 已 准备 就 绪 。 


11.7.4 什么 需要 保持 
有 时 ， 最 好 的 行动 就 是 不 行动 , 换 句 话说 ， 就 是 要 把 团队 已 经 做 了 但 还 没有 形成 习惯 的 事情 
记录 下 来 。 这 是 什么 需要 保持 这 个 问题 的 主题 。 


STEVE: 那么 , 有 什么 需要 保持 的 吗 ? 有 什么 我 们 在 这 个 冲刺 首次 采用 且 应 该 继续 
保持 下 去 的 吗 ? 


每 个 人 依然 不 说 话 。 
STEVE: 好 吧 ， 如 果 有 人 会 议 之 后 想起 任何 需要 保持 的 事情 ,请 告诉 我 ， 我 们 也 会 
为 它们 制定 行动 计划 。 

















11.7.5” 遇 到 了 什么 意料 之 外 的 事情 
几乎 每 个 冲刺 我 们 都 会 遇 到 一 些 意料 之 外 的 事情 。 团 队 可 能 会 发 现 一 个 旧 的 流程 需要 更 新 ， 
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有 需求 被 遗漏 ， 软 件 的 一 部 分 功能 突然 又 不 工作 了 等 。 回 顾 会 议 中 找 出 这 些 意外 的 目的 是 让 团队 
以 后 碰 到 这 些 事情 时 不 再 感到 意外 。 

STEVE: 大 家 有 没有 遇 到 什么 意料 之 外 的 事情 ? 

DAVID: 我 很 意外 客户 对 我 提出 的 内 容 过 滤器 很 感 兴趣 。 

DIANNE: 说 实在 的 ， 你 的 主意 很 有 意义 。 客户 对 Proseware 的 定位 是 一 些 特定 的 人 
群 ， 内 容 过 滤 很 可 能 会 给 他 们 带 来 很 多 价值 。 

PETRA: 我 同意 Dianne 说 的 ， 这 的确 是 一 个 很 棒 的 主意 。 所 以 我 们 真 的 应 该 继续 保 
持 一 些 事情 ， 比 如 继续 保持 对 新 想法 的 思考 。 
Steve 在 白板 上 需要 保持 事项 一 列 中 添加 了 一 条 记录 。 

TOM: 我 很 惊讶 ， 在 这 个 项 目 上 Steve 和 Dianne 竟 然 没 有 专职 工作 。 

PETRA: 是 啊 ， 其 他 人 是 否 也 觉得 意外 ? 

DIANNE: 这 也 让 我 感到 意外 。 我 给 别人 的 印象 是 我 是 专职 完成 Proseware 项 目的 ， 
但 是 实际 上 Steve 和 我 却 被 安排 去 帮 另 外 一 个 项 目 救 火 。 

STEVE: 我 们 应 该 和 管理 达成 某 些 协议 ， 以 保证 下 一 个 冲刺 中 去 征调 其 他 人 ， 而 不 
是 我 们 。 

DIANNE: 这 个 计划 好 。 
Steve 在 白板 上 记 下 了 这 个 行动 计划 。 

STEVE: 好 了 , 谢谢 大 家 。 这 个 冲刺 整体 很 不 错 ,， 给 项 目 开 了 一 个 好 头 。 让 我 们 继 
续 保持 。 

PETRA: 我 赞同 Steve 的 总 结 。 让 我 们 开始 执行 这 次 回顾 会 议 所 达成 的 行动 计划 ， 
并 且 确 保 我 们 下 一 个 冲刺 也 做 这 样 的 回顾 和 计划 。 
会 议 圆满 结束 ， 团 队 成 员 都 离开 了 会 议 室 。 
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对 于 Proseware 项 目的 团队 而 言 ， 第 一 个 冲刺 是 成 功 的 。 尽 管 不 是 所 有 事情 都 按照 计划 进行 ， 
但 团队 已 经 早早 收集 到 了 很 多 有 价值 的 反馈 。 这 是 任何 敏捷 流程 的 关键 : 总 是 要 为 建设 性 的 批判 
采取 纠正 措施 。 

下 一 章 中 ， 团 队 会 继续 进行 第 二 个 冲刺 以 实现 剩余 的 用 户 故 事 。 
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完成 本 章 学 习 之 后 ， 你 将 学 到 以 下 技能 。 

口 观摩 团队 第 二 个 冲刺 中 计划 会 议 的 过 程 。 

口 追踪 剩余 用 户 故 事 的 实现 和 演进 过 程 。 

口 观摩 团队 第 二 个 冲刺 中 演示 和 回顾 会 议 的 过 程 。 

本 章 中 ，Trey Research 团 队 会 继续 为 Proseware 项 目 实现 剩余 的 用 户 故 事 。 根 据 第 一 个 冲刺 
中 回顾 会 议 上 用 户 的 反馈 ， 团 队 对 开发 方向 做 了 些微 的 调整 ， 并 为 第 二 个 冲刺 设置 了 下 面 的 冲 
刺 目标 。 

会 话 中 可 以 发 送 格式 化 文本 ， 可 以 过 滤 消 息 内 容 以 确保 它 是 合适 的 ,确保 可 以 同时 
支持 三 百 个 用 户 。 

这 个 冲刺 承诺 完成 剩余 的 所 有 故事 。 按照 惯例 , 团队 会 在 冲刺 收尾 时 的 演示 会 议 上 给 用 户 做 
演示 ， 以 向 用 户 展 示 产 品 开发 的 进度 并 收集 用 户 的 反馈 。 在 接 下 来 的 回顾 会 议 上 ,团队 还 会 讨论 
冲刺 期 间 做 得 好 的 事情 和 做 得 不 太 好 的 事情 。 

团队 首先 从 这 个 冲刺 的 计划 会 议 开 始 。 


12.1 计划 会 议 


在 项 目 第 二 个 冲刺 的 计划 会 议 上 , 团队 成 员 会 一 起 讨论 与 这 个 冲刺 目标 相关 的 用 户 故 事 。 第 
二 个 冲刺 包括 以 下 用 户 故 事 。 
口 我 想 发 送 正确 格式 化 的 标记 。 
口 我 想 过 滤 消 息 内 容 以 确保 它 是 适合 发 表 的 。 
口 我 想 同 时 服务 数 百 个 用 户 。 
所 有 人 都 在 会 议 室 就 坐 后 ， 会 议 就 开始 了 。 
PETRA: 根据 上 个 冲刺 的 演示 会 议 上 客户 的 反馈 , 我 们 的 用 户 故事 积压 工作 上 多 了 
一 项 。 
STEVE: 客户 想 要 我 们 先 实现 内 容 过 滤 的 故事 ， 以 取代 原 计划 的 只 读 会 话 的 故事 。 
DIANNE: 所 以 我 们 应 该 先 估算 这 个 新 的 故事 。 
STEVE: 是 的 ， 我 们 完成 估算 后 才能 知道 在 这 个 冲刺 中 我 们 的 开发 资源 还 有 多 少 。 
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DIANNE: 好 的 ， 那 我 们 就 在 数 到 三 的 时 候 ， 一 起 亮 出 自己 的 点 数 估算 扑克 。 
每 个 人 在 亮 出 扑克 之 前 都 掩盖 着 它 。 

PETRA TOM STEVE DIANNE DAVID 

3 3 8 5 8 

STEVE: 哇 哦 ， 我 们 的 估算 差异 比较 大 。Tom， 你 能 解释 一 下 为 何 是 三 个 点 吗 ? 

TOM: 我 选择 三 个 点 ， 主 要 因为 我 可 以 很 容易 自动 化 测试 这 个 故事 。 这 个 根据 受 
限 词汇 库 来 判断 文字 信息 是 否 可 以 发 送 的 用 例 是 比较 简单 的 。 如 果 用 更 复杂 的 技术 实 
现 ， 我 也 愿意 增加 估算 值 。 

STEVE: David， 你 能 解释 一 下 你 的 八 个 点 的 估算 吗 ? 我 也 会 随后 给 出 我 的 理由 。 

DAVID: 好 的 。 我 认为 实现 会 比较 困难 ,因为 我 们 需要 为 受 限 词汇 增加 一 个 新 的 数 
据 表 ， 而 这 是 需要 一 定 的 时 间 才 可 以 实现 的 。 

STEVE: 是 的 ,我 也 是 这 样 想 的 。 我 还 考虑 到 ， 我 们 不 能 只 想 限 制 用 户 会 话 中 的 消 
息 文字 ， 也 应 该 检查 他 们 给 房间 起 的 名 称 。 实 际 上 ， 用 户 的 任何 输入 都 应 该 经 过 内 容 过 
滤 检 查 后 才能 提交 并 发 表 。 

DIANNE: 现在 我 们 可 以 先 实现 一 个 由 数据 驱动 的 内 容 过 滤器 ， 把 方案 简化 为 使 用 
固定 的 词汇 列表 ， 怎 么 样 ? 

STEVE: 好 的 , 这 个 主意 不 错 。 后 面 我 们 再 专门 针对 内 容 过 滤器 的 管理 增加 相应 的 
用 户 故 事 。 

PETRA: 好 ， 那 我 们 是 要 重新 估算 ， 还 是 直接 按照 五 个 点 的 估算 来 ? 

TOM: 我 觉得 五 个 点 可 以 。 

STEVE: 嗯 ， 五 个 点 挺 合适 。 

DAVID: 我 同意 ， 就 按照 五 个 点 来 。 

PETRA: 好 的 ,谢谢 大 家 。 让 我 们 一 起 努力 确保 完成 这 个 冲刺 的 所 有 目标 吧 ， 这样 
就 可 以 在 这 周 给 客户 做 一 个 精彩 的 演示 。 

大 家 陆续 走出 了 会 议 室 ， 准 备 开始 动工 了 。 
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在 开始 实现 故事 之 前 ，David 向 Steve 请 教 有 关 解 析 标 记 的 事情 。 

DAVID: 我 觉得 我 们 应 该 使 用 一 个 第 三 方 库 来 完成 解析 标记 并 转换 为 HTML 的 工 
作 。 但 是 我 不 确定 要 使 用 哪个 库 。 

STEVE: 好 的 ， 等 一 等 。 我 知道 Dianne 有 这 方面 的 经 验 。 让 我 们 一 起 请 教 她 吧 。 
Steve 招 呼 Dianne 过 来 ， 并 请 教 她 有 关 标 记 库 的 事情 。 

STEVE: Dianne， 你 以 前 使 用 过 一 些 标记 库 ， 对 吧 ? 你 觉得 哪个 好 呢 ? 

DIANNE: 我 以 前 评估 过 一 些 这 方面 的 第 三 方 库 。 试 一 坛 MarkDownDeep， 它 应 该 





可 以 满足 我 们 的 需求 了 。 大 家 可 以 通过 NuGet 获 取 它 的 包 

STEVE: 谢谢 你 ，Dianne。David， A 一 试 MarkDownDeepre。 还 有 ， 要 确 
保 创 建 一 个 我 们 自己 的 库 对 MarkDownDeep 进 行 适 配 ， 这 样 做 ,项 目的 其 他 库 就 都 只 需 
要 依赖 这 个 我 们 自己 的 适 配 库 。 

DAVID: 好 的 ， 谢 啦 。 


David 开 始 着 手 为 项 目 实现 标记 传输 的 功能 。 过 了 几 个 小 时 后 ， 他 做 好 了 给 Steve 和 Dianne 展 
示 自 己 实现 的 准备 ， 然 后 他 像 第 一 个 冲刺 一 样 请 求 他 们 一 起 给 他 的 代码 做 同行 评审 。 


DAVID: 我 想 知道 标记 传输 实现 的 最 佳 位 置 是 哪里 。 我 知道 我 可 以 通过 为 现 有 接口 
增加 一 个 修饰 器 实现 来 截获 房间 的 消息 文本 。 我 想 ， 如 果 在 IMessageRepository 接 口 
的 AddMessageToRoom 方 法 中 实现 它 的 话 ， 我 们 就 可 以 不 用 在 读 取 时 处 理 标记 了 。 如 果 
我 们 只 是 在 保存 消息 时 将 标记 转换 为 HTML ， 我 们 就 不 需要 再 操心 标记 的 事情 了 。 

DIANNE: 这 样 的 确 可 以 避免 每 次 读 取 时 进行 标记 到 HTMEL 的 转换 ， 但 实际 上 它 
不 能 正常 工作 。 

DAVID: 是 的 ,我 也 认识 到 如 果 我 们 在 保存 消息 时 进行 转换 的 话 ， 就 不 能 再 编辑 消 
息 了 。 我 知道 我 们 现在 还 没有 这 个 特性 , 但 是 我 想 将 来 可 能 会 有 这 个 需求 ,我 不 想 让 用 
户 无 法 编辑 消息 。 

STEVE: 很 好 。 其实 我 们 几乎 可 以 肯定 后 期 会 有 你 所 说 的 需求 ,所 以 应 该 在 读 取 时 
处 理 标记 转换 ， 而 不 是 在 编写 消息 时 完成 这 个 动作 。 

DD UI 是 在 客户 端 进行 转换 ， 还 是 在 服 
务 器 端 进行 转换 ? 我 现在 暂时 选择 在 服务 器 端 实现 。 但 是 我 想 知 道 ， 是 否 应 该 在 浏览 
器 的 客户 端 完成 这 个 动作 ? 

DIANNE: 或 许 我 们 能 基于 这 个 本 地 转换 功能 为 用 户 提供 这 样 一 个 特性 : 用 户 在 输 
入 消息 时 能 即时 预览 标记 和 HTML 格式 的 显示 。 

STEVE: 好 主意 , Dianne。 我 会 记 下 这 个 , 然后 在 演示 会 议 上 征求 客户 的 意见 和 想法 。 

DAVID: 最 后 , 我 是 将 转换 功能 作为 TRoomViewMode1Reader 接 口 的 一 个 修饰 器 实 
现 。 因 为 标记 和 HTML 都 只 是 用 户 界 面相 关 的 概念 ，IRoomViewMode1Reader 接 口 又 是 
一 个 用 户 界 面 的 契约 。 还 可 以 用 ya IRoomRepository 接 口 或 IMessageRepo- 
sitory 接 口 ， 但 这 两 个 都 是 数据 契 还 有 ， 我 对 自己 写 的 代码 不 是 完全 满意 ， 你 们 
帮 我 看 看 。 


David 给 Steve 和 Dianne 展 示 了 他 实现 的 标记 修饰 咒 ， 如 代码 清单 12-1 所 示 。 
代码 清单 12-1 标记 修饰 器 可 以 将 用 户 输入 的 标记 转换 为 HTML 


public class RoomViewModelReaderMarkdownDecorator : IRoomViewModelReader 


{ 





public RoomViewModelReaderMarkdownDecorator( 
IRoomViewModelReader @Qdelegate, 
Markdown markdown) 
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{ 
this.Qdelegate = @Qdelegate; 
this.markdown = markdown; 
} 
public IEnumerab le<RoomViewMode1> GetAllRooms() 
{ 
return Qdelegate.CGetAllRooms(); 
} 
public IEnumerable<MessageViewModel> GetRoomMessages(int roomID) 
{ 
var roomMessages = @Qdelegate.GetRoomMessages (roomID); 
foreach(var viewModel in roomMessages) 
{ 
viewModel.Text = markdown.Transform(viewModel.Text); 
} 
return roomMessages; 
} 


private readonly IRoomViewModelReader @Qdelegate; 
private readonly Markdown markdown ; 


STEVE: 对 我 来 说 ， 你 的 实现 挺 好 的 。 你 觉得 什么 地 方 不 满意 呢 ? 

DAVID: 有 两 个 地 方 我 不 满意 。 第 一 ,我 们 直接 依赖 了 MarkdownDeep 库 的 Markdown 
类 。 这 个 不 是 应 该 隐藏 到 一 个 单独 的 接口 后 吗 ? 

DIANNE: 我 觉得 给 修饰 器 直接 注入 该 类 的 依赖 是 可 以 接受 的 。 因 为 Markdown 类 
相当 小 ， 我 们 后 期 要 更 换 成 另外 一 个 库 的 工作 量 也 不 大 。 

DAVID: 不 大 就 好 。 直 接 使 用 Markdown 类 也 能 让 我 的 针对 期 待 转换 结果 的 单元 测 
试 更 简单 些 。 这 是 我 写 的 单元 测试 代码 。 
David 打 开 了 包含 他 编写 的 标记 单元 测试 代码 的 文件 ， 如 代码 清单 12-2 所 示 。 


代码 清单 12-2 ”针对 标记 转换 修饰 右 的 单元 测试 


[TestFixturel] 
public class MarkdownTests 


{ 





[Test] 
[TestCase( 
"This message has only paragraph markdown...", 
"<p>This message has only paragraph markdown...</p>\n")] 
[TestCase( 
"This message has *some emphasized* markdown...", 
"<p>This message has <em>some emphasized</em> markdown...</p>\n")] 
[TestCase( 
"This message has **some strongly emphasized** markdown...", 
"<p>This message has <strong>some strongly emphasized</strong> 
markdown...</p>\n")] 
public void MessageTextIsAsExpectedAfterMarkdownTransform(string markdownText, 
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string expectedText) 
{ 


messagel.Text = markdownText; 
var markdownDecorator = new 
RoomViewModelReaderMarkdownDecorator (mockRoomViewModelReader.Object, markdown); 
var roomMessages = markdownDecorator.CGetRoomMessages (12345); 
var actualMessage = roomMessages.FirstOrDefault(); 


Assert.That(actualMessage, Is.Not.Null); 


Assert.That(actualMessage.Text, Is.EqualTo(expectedText)); 


} 
[SetUp] 
public void SetUpQO) 
{ 
markdown = new Markdown QO); 
messagel = new MessageViewModel 
{ 
AuthorName = "Dianne", 
TD = 
RoomID = 12345, 
TS ESSE 
二 
mockRoomViewModelReader = new Mock<IRoomViewModelReader>(); 
var roomMessages = new MessageViewModel[] 
{ 
messagel 
bE 
mockRoomViewModelReader.Setup(reader => 
reader .GetRoomMessages(It.IsAny<int>())) .ReturnsCroomMessages) ; 
} 


private MessageViewModel messagel; 
private Mock<IRoomViewModelReader> mockRoomViewModelReader; 
private Markdown markdown ; 


STEVE: 单元 测试 的 实现 也 挺 好 啊 。 你 不 是 说 还 有 一 个 地 方 有 所 顾虑 吗 ? 

DAVID: 是 啊 ,， 你们 注意 一 下 修饰 ITRoomViewMode1Reader 接 口 的 标记 类 型 ， 它 也 
有 一 个 GetA11Rooms 方 法 。 这 里 ， 是 不 是 可 以 做 接口 分 离 ? 因为 它 的 GetA11Rooms 方 法 
只 是 直接 委托 被 包装 的 实例 来 完成 实际 的 工作 而 已 。 

DIANNE: 我 们 也 应 该 允许 用 户 在 房间 名 称 里 使 用 标记 吧 ? 如 果 允 许 的 话 ， 那 
GetA11Rooms 方 法 也 会 需要 做 修饰 的 动作 了 。 

STEVE: 我 认为 代码 实现 可 以 保持 现状 。 我 们 先 暂 时 不 要 做 接口 分 离 ， 也 暂时 不 允 
许 房间 名 称 使 用 标记 。 后 面 我 们 可 以 基于 演示 会 议 上 客户 的 反馈 再 做 决定 。 
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12.3 “我 想 过 滤 消 息 内 容 以 确保 它 是 适合 发 表 的 ” 


Dianne 和 David 都 被 安排 来 实现 消息 内 容 过 滤 的 用 户 故 事 。 他 们 再 次 通过 结对 编程 来 一 起 实 
现 这 个 故事 所 需 的 功能 。 
DIANNE: 按照 我 们 在 计划 会 议 上 的 讨论 结果 ,这 个 冲刺 , 我 们 先 不 去 实现 一 个 完整 
的 由 数据 驱动 的 消息 过 滤器 。 但 是 ， 我 们 需要 为 将 来 切换 到 完整 的 数据 过 滤器 打 好 基础 。 
DAVID: 那么 这 个 冲刺 就 只 实现 数据 访问 部 分 ， 然 后 下 周 再 继续 剩余 部 分 ? 


DIANNE: 不 , 我们 不 能 这 样 做 。 我们 依然 需要 交付 一 个 竖 切 可 用 的 功能 ， 它 是 可 
以 给 用 户 演示 的 东西 ,但 可 以 不 完整 。 如 果 我 们 只 实现 数据 访问 部 分 ,这 不 会 给 客户 带 


来 任何 价值 。 

DAVID: 我 不 太 明 白 你 说 的 。 既 能 给 用 户 展示 价值 , 但 又 不 是 完整 的 内 容 过 滤器 ? 

DIANNE: 我 们 要 做 的 是 在 菜 个 地 方 采用 折 中 的 方案 以 便 可 以 短 时 间 实 现 , 但 依然 
在 整体 上 可 以 给 客户 提供 一 些 价值 。 对 于 这 个 故事 ,需要 折 中 的 地 方 很 清楚 : 受 限 词汇 
的 列表 应 该 直接 硬 编码 ， 而 不 是 从 诸如 数据 库 等 持久 存储 中 读 取 。 

DAVID: 我 觉得 这 个 是 可 以 的 。 但是， 据 我 了 解 ， 任 何 硬 编 码 都 是 不 太 好 的 。 应 用 
硬 编 码 的 都 是 不 好 的 方案 ， 对 吗 ? 

DIANNE: 一 定 程 度 上 ,是 的 。 这 是 一 个 技术 债务 。 我 们 是 在 慎重 地 做 出 使 用 折 中 
方案 的 决定 ,以 便 能 够 尽早 交付 一 些 东 西 。 也许 客 户 知道 自己 想 要 的 受 限 词汇 清单 而 且 
永远 不 会 改变 。 如 果真 是 这 样 ， 我 们 就 可 以 用 这 样 的 硬 编码 清单 来 完成 故事 。 

DAVID: 我 觉得 这 招 很 好 ,， 真 的 。 我 们 把 更 简单 的 方案 看 作 是 实现 最 终 目 标 路 上 的 
一 个 中 间 目 标 ， 而 不 是 直接 耗费 大 量 时 间 来 实现 一 个 东西 。 

DIANNE: 正 是 这 样 ! 而 且 ， 每 当 达 成 一 个 中 间 目 标 时 ， 接 下 来 的 中 间 目 标 也 许 会 
变 得 截然 不 同 ， 黄 至 最 终 目标 也 可 能 会 发 生 彻 底 的 改变 。 

DAVID: 另 一 个 我 不 太 确 认 的 事情 是 : 我 们 应 该 如 何 实现 这 个 故事 ? 为 消息 编写 器 
创建 一 个 修饰 器 ， 当 消息 中 有 受 限 词汇 时 就 引发 异常 ? 

DIANNE: 你 这 个 建议 的 问题 在 于 把 异常 用 在 正常 的 控制 流程 中 了 。 异 常 最 好 只 用 
于 真正 意外 的 情况 。 现 在 这 个 故事 更 多 的 是 一 个 验证 场景 。 

DAVID: 哦 , 我 明白 了 。 所 以 我 们 应 该 名 入 MVC 框 架 中 的 验证 机 制 ， 当 消息 包含 
了 受 限 词汇 时 就 让 验证 失败 ? 

DIANNE: 嘿 ， 你 这 个 主意 不 错 。 那 么 我 们 这 样 实现 ……? 


Dianne 直 接 开 始 编 写 代码 ， 过 了 十 几 分 钟 ， 创 建 了 如 代码 清单 12-3 所 示 的 类 。 
代码 清单 12-3 ”上 自 定 义 验 证 属性 非常 适合 内 容 过 小 带 


public class ContentFilteredAttribute : ValidationAttribute 
{ 


private readonly string[|] blockedWords = new string[] 


{ 
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"heffalump", 
"woozle", 
"jabberwocky", 
"frabjous", 
"bandersnatch" 


bs 


protected override ValidationResult IsValid(object value, 
ValidationContext validationContext) 


{ 
var validationResult = ValidationResult.Success; 
if (value != null && value is string) 
{ 
var valueString = (string)value; 
if(blockedWords .Any(inappropriateWord => 
valueString.ToLowerInvariant() 
.Contains(inappropriateWord.ToLowerInvariant()))) 
{ 
var errorMessage = FormatErrorMessage(validationContext.DisplayName); 
validationResult = new ValidationResult(errorMessage); 
} 
} 
return validationResult; 
} 


DIANNE: 我 专门 使 用 了 一 些 明显 不 真实 的 受 限 词汇 ,因为 我 不 想 给 用 户 的 演示 包 
括 任何 真正 的 受 限 词汇 。 
DAVID: 别 ,当然 。 我 认为 只 要 很 好 地 展示 了 功能 即 可 。 现 在 我 们 开始 写 单 元 测试 ? 
DIANNE: 好 ， 单 元 测试 是 这 样 的 。 
代码 清单 12-4 展 示 了 两 个 针对 RoomContro11erTests 类 的 单元 测试 。 


代码 清单 12-4 添加 单元 测试 是 为 了 强制 执行 房间 名 称 和 消息 文本 上 的 验证 规则 


[Test] 
[TestCase("Callooh! Callay! 0 frabjous day!")] 
[TestCase("The frumious Bandersnatch!")] 


[TestCase("A heffalump or woozle is very confusel...")] 
public void PostCreateNewRoomWithBlockedWordsCausesValidationError(string roomName) 
{ 


var controller = CreateControllerQO); 

var viewModel = new RoomViewModel { Name = roomName }; 

var context = new ValidationContext(viewModel, serviceProvider: null, items: null); 
var results = new List<ValidationResu1lt>() ; 


var isValid = Validator.TryValidateObject(viewModel, context, results, true); 


Assert.That(isValid, Is.False); 
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} 

人 

[Test] 

[TestCase("Callooh! Callay! 0 frabjous day!")] 
[TestCase("The frumious Bandersnatch!")] 


[TestCase("A heffalump or woozle is very confusel...")] 
public void PostAddMessageWithBlockedWordsCausesValidationError(string text) 
{ 


var controller = CreateControllerQO; 


var viewModel = new MessageViewModel { AuthorName = "David", Text = text}; 
var context = new ValidationContext(viewModel, serviceProvider: null, items: null); 
var results = new List<ValidationResu1lt>() ; 


var isValid = Validator.TryValidateObject(viewModel, context, results, true); 


Assert.That(isValid, Is.False); 


DAVID: 使 用 视图 模型 中 带 有 ContentFiltered 标 记 的 两 个 属性 ， 这 些 测试 会 很 
快 成 功 通过 验收 的 。 

DIANNE: 当然 。 只 是 我 依然 觉得 现在 的 设计 有 些 部 分 不 顺眼 。 

DAVID: 哪些 部 分 ? 

DIANNE: 很 明显 的 是 ， 硬 编码 的 受 限 词汇 列表 。 虽 然 我 们 已 经 决定 把 它 看 作 技术 
债务 ， 但 是 我 依然 想 要 从 一 个 提供 者 接口 中 获取 这 些 受 限 的 词汇 清单 。 按 照 这 个 思路 ， 
我 可 以 创建 一 个 临时 实现 类 用 于 返回 一 个 静态 的 硬 编码 的 受 限 词汇 列表 , 这 就 为 以 后 真 
正 的 数据 驱动 实现 提供 了 扩展 点 。 

DAVID: 是 的 , 这 样 就 可 以 把 受 限 词汇 列表 数据 从 验证 算法 中 分 离 出 去 。 我 们 可 以 
在 这 里 使 用 依赖 注入 吗 ? 

DIANNE: 很 不 幸 ， 不 可 以 。 这 些 自 定义 属性 并 不 是 很 灵活 ， 因 为 不 可 以 从 控制 器 
或 者 MVC 提 供 的 其 他 扩展 点 创建 它 。 

DAVID: 很 可 惜 啊 。 那 么 服务 定位 器 模式 怎么 样 ? 

DIANNE: 我 通常 会 把 它 看 作 反 模式 ， 但 是 现在 这 个 用 例 中 ， 服 务 定 位 器 应 该 是 可 
用 的 最 佳 选 择 了 。 

DAVID: 我 们 是 否 应 该 保持 现 有 的 代码 结构 ,就 把 这 些 属性 标记 为 技术 债务 ， 可 以 
吗 ? 这 样 做 ， 我 们 就 可 以 继续 开发 ， 也 可 以 在 需要 的 时 候 返回 重 构 这 部 分 代码 。 

DIANNE: 我 同意 。 我 认为 这 里 有 关 受 限 词汇 的 需求 很 可 能 会 在 将 来 发 生 彻 底 的 变 
化 ， 而 且 目 前 我 们 无 法 猜测 它 会 朝 哪个 方向 发 展 。 


12.4 “我 想 同时 服务 数 百 个 用 户 ” 
冲刺 的 最 后 一 个 故事 要 求 Dianne 和 Steve 增 强 应 用 程序 的 扩展 性 ,客户 需要 应 用 程序 支持 水 平 扩 42 
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展 , 而 不 是 重 置 扩展 。 水 平 扩展 是 指 应 用 程序 应 该 能 够 通过 额外 的 服务 机 需 以 支持 更 多 用 户 的 并 发 
访问 。 与 此 相 比 ， 垂 直 扩展 是 指 应 用 程序 在 通过 增强 单个 机 需 的 能 力 以 支持 更 多 用 户 的 并 发 访问 。 
Dianne 和 Steve 明 白水 平 扩展 的 受 限 点 在 于 诸如 Microsoft SQL Server 等 关系 型 数据 库 管 理 系 
统 (Relational Database Management System ，RDMS ) 的 架构 。 与 本 身 就 支持 水 平 扩展 的 带 有 专 
门 设置 的 分 布 式 存储 方案 相 比 ， 现 有 的 架构 很 难 在 服务 集群 中 的 另外 一 人 台 机 需 中 增加 一 个 新 的 
SQL Server 实 例 。 
基于 这 样 的 认识 ，Dianne 研 究 了 可 供 替 代 SQL Server 数 据 库 的 各 种 文档 存储 的 候选 项 。 她 向 
队 推 荐 了 MongoDB ， 认 为 它 是 一 个 可 靠 且 流行 的 ， 能 很 好 地 通过 增加 新 服务 器 来 扩展 应 用 程 
序 能 力 的 文档 存储 系统 。 现 在 唯一 的 问题 是 ， 应 用 程序 是 从 SQL Server 存 取 房 间 和 消息 数据 的 。 
幸好 团队 已 经 通过 面向 接口 编程 为 存储 架构 的 改变 提供 了 扩展 点 。 
DIANNE: 我 们 要 做 的 就 是 为 房间 和 消息 存储 库 这 两 个 接口 创建 一 个 新 的 实现 。 
STEVE: 嗯 , 我 肯定 可 以 那样 做 , 但 是 我 认为 可 以 把 记录 数据 到 视图 模型 的 数据 转 
换 直 接 干 挤 ， 取 而 代 之 的 是 ， 直 接 序列 化 和 反 序 列 化 我 们 的 视图 模型 。 
DIANNE : 听 起 来 有 点 意思 ! 我 们 要 做 的 只 是 为 ITRoomViewMode1Reader 和 
IRoomViewModeWriter 两 个 接口 创建 直接 使 用 MongoDB 的 新 实现 。 
STEVE: 说 得 很 对 。 
两 个 人 开始 实现 MongoRoomViewMode1Storage 类 ， 如 代码 清单 12-5 所 示 。 


代码 清单 12-5 MongoDB 的 数据 持久 性 层 的 实现 


public class MongoRoomViewModelStorage : IRoomViewModelReader, IRoomViewModelWriter 




















{ 
public MongoRoomViewModelStorage(IApplicationSettings applicationSettings) 
{ 
this.applicationSettings = applicationSettings; 
} 
public IEnumerab le<RoomVvViewMode1> GetAllRooms() 
{ 
var roomsCollection = GetRoomsCollectionQ; 
return roomsCollection.FindAl11QO; 
} 
public void CreateRoom(RoomViewModel roomViewModel) 
{ 
var roomsCollection = GetRoomsCollection() ; 
roomsCollection.Save(roomViewModel); 
} 


public IEnumerab le<MessageViewMode1> GetRoomMessages(int roomID) 
{ 
var messageQuery = Query<MessageViewModel> 
.EQ(viewModel => viewModel.RoomID, roomID); 
var messagesCollection = GetMessagesCollection(Q); 
return messagesCollection.Find(messageQuery); 
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} 
public void AddMessage(MessageViewModel messageViewModel) 
{ 
var messagesCollection = GetMessagesCollection(); 
messagesCollection.Save(messageViewModel); 
} 
private MongoCollection<MessageViewModel> GetMessagesCollection() 
{ 
var database = GetDatabase(); 
var messagesCollection = database. 
GetCollection<MessageViewModel>(MessagesCollection); 
return messagesCollection; 
} 
private MongoCollection<RoomViewModel> GetRoomsCollectionQ) 
{ 
var database = GetDatabase(); 
var roomsCollection = database.GetCollection<RoomViewModel>(RoomsCollection); 
return roomsCollection; 
} 
private MongoDatabase GetDatabase() 
{ 
var connectionString = applicationSettings.GetValue(MongoConnectionString); 
var client = new MongoClient(connectionString); 
var server = client.GetServerQO; 
return server.GetDatabase(ProsewareDatabase); 
} 
private readonly IApplicationSettings applicationSettings; 
private static string MongoConnectionString = "MongoConnectionString"; 
private static string ProsewareDatabase = "Proseware"; 
private static string MessagesCollection = "messages"; 
private static string RoomsCollection = "rooms"; 





完成 这 个 故事 之 后 ,团队 就 不 会 再 因为 为 Proseware 应 用 程序 和 客户 提供 水 平 扩展 能 力 的 局 限 
而 受到 束缚 了 。 


12.5 ”演示 会 议 


第 二 个 冲刺 的 收尾 阶段 , 团队 为 客户 准备 了 为 外 一 次 演示 。 会 议 上 会 整理 并 展示 这 个 冲刺 完 
成 的 每 个 故事 的 功能 。 从 第 一 个 冲刺 回顾 会 议 总 结 的 一 个 关键 行动 就 是 改善 演示 会 议 的 准备 情 
况 。 团队 认真 地 做 了 准备 , 在 没有 客户 参与 的 情况 下 , 在 会 前 完整 地 进行 了 一 次 功能 展示 的 预演 。 
这 个 过 程 有 助 于 减少 因为 开发 和 演示 环境 不 同 所 造成 的 问题 。 预演 过 程 很 顺利 , 所 以 团队 做 好 了 
给 客户 展示 项 目 进 度 的 准备 。 
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展示 标记 故事 时 , 团队 向 客户 代表 征求 了 意见 , 问 他 是 否 也 想 要 房间 名 称 和 消息 内 容 可 以 使 
用 同样 的 格式 化 标记 。 客 户 似 乎 接受 了 这 个 建议 ， 并 且 让 团队 把 这 个 也 加 入 到 产品 积压 工作 中 ， 
但 同时 也 表明 这 只 是 一 个 较 低 优 先 级 的 故事 ,因为 他 很 快 会 有 更 重要 的 特性 需求 。 客户 也 很 高 兴 
团队 使 用 了 简单 的 标记 语言 ， 而 不 是 原来 要 求 的 HTML 格 式 ， 因 为 客户 也 了 解 到 标记 语言 是 一 种 
日 益 流行 、 友 好 随意 的 文本 格式 化 方式 。 

下 一 个 展示 的 故事 是 消息 内 容 过 滤 。 对 于 团队 已 经 给 房间 名 称 和 消息 文本 都 应 用 了 内 容 过 滤 
人 胡 ， 客户 也 赞同 以 后 所 有 接受 用 户 输入 的 地 方 都 要 应 用 同样 的 文本 过 滤 副 。 然 而 ,客户 提出 了 一 
个 额外 的 需求 ， 就 是 以 后 能 通过 配置 来 启用 和 禁用 文本 过 滤 需 的 功能 。 

在 测试 冲刺 的 最 后 一 个 故事 时 ，Tom 一 次 模拟 了 300 个 用 户 来 操作 分 布 在 两 合 独立 机 希 上 的 
数据 。 客 户 再 一 次 要 求 能 用 配置 来 控制 数据 源 。 

看 完 所 有 故事 的 展示 后 , 客户 表达 了 他 对 团队 的 赞赏 , 他 非常 高 兴 能 看 到 团队 能 在 短 短 的 两 
个 单 周 的 冲刺 里 逐步 取得 了 这 么 多 切实 可 见 的 进展 。 























12.6 ”回顾 会 议 


与 第 一 个 冲刺 结束 时 一 样 ， 第 二 个 冲刺 结束 时 ,团队 也 聚集 在 一 起 讨论 过 去 一 周 的 进展 。 所 
有 团队 成 员 都 要 讨论 和 回答 以 下 问题 。 

口 什么 做 得 比较 好 ? 

口 什么 做 得 不 太 好 ? 





口 冲刺 中 有 没有 需要 保持 的 新 东西 ? 
口 冲刺 中 有 没有 发 现任 何 意料 之 外 的 事情 ? 
冲刺 会 议 的 目标 是 生成 一 个 可 执行 的 、 排 好 序 的 工作 项 列表 ， 然 后 在 会 后 实施 。 按 照 惯例 ， 
会 议 的 输出 不 是 为 了 生成 无 法 切实 执行 的 结论 。 
在 一 个 舒适 的 会 议 室 里 ， 团 队 成 员 对 列表 中 的 问题 进行 逐一 讨论 。 
12.6.1 什么 做 得 比较 好 
团队 首先 讨论 了 这 个 冲刺 中 做 得 比较 好 的 事情 。 
STEVE: 大 家 认为 我 们 这 个 冲刺 中 什么 做 得 比较 好 ? 
PETRA: 个 人 意见 , 我 认为 这 个 冲刺 很 成 功 : 我 们 按时 完成 了 冲刺 目标 ,演示 会 议 
的 准备 工作 也 做 得 很 充分 ， 通 过 准备 保证 了 演示 的 整个 过 程 都 很 成 功 。 客 户 也 很 满意 ， 
我 们 也 对 自己 的 付出 所 获得 的 成 果 感 到 满意 。 
DIANNE: 我 同意 。 这 个 冲刺 可 以 作为 后 续 冲 刺 执 行 的 一 个 模板 。 但 是 我 们 也 不 能 
忘记 重点 : 我 们 必须 要 朝 着 能 够 长 期 保持 这 种 水 平 而 努力 。 
STEVE: 那 当 然 ， 大 家 一 定 不 要 骄傲 自满 。 
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12.6.2 ”什么 做 得 不 太 好 
团队 接着 讨论 这 个 冲刺 中 做 得 不 好 的 事情 。 
STEVE: 那么 什么 没 做 好 呢 ? 肯定 有 事情 并 没有 按照 计划 进行 。 
DAVID: 我 认为 有 些 问题 在 冲刺 中 一 直 处 于 没有 答案 的 状态 。 这 些 问 题 对 实现 整体 
的 影响 不 大 ， 但 是 我 认为 应 该 尽快 确定 这 些 问 题 的 答案 ， 而 不 是 一 直 等 到 冲刺 结束 。 
STEVE: 什么 样 的 问题 呢 ，David? 你 能 举 个 例子 吗 ? 
DAVID: 在 标记 转换 的 故事 里 ，Dianne 曾 经 问 我 们 ,房间 名 称 是 否 也 要 像 消 息 一 样 
做 转 挽 。 我 选择 不 去 做 ， 但 是 我 们 实际 上 并 不 知道 明确 的 答案 。 


12.6.3 ”什么 需要 改变 
团队 成 员 接 着 讨论 需要 改善 的 流程 和 工作 实践 的 有 关 事 项 。 

DIANNE: 是 的 , 我 同意 。 我 认为 我 们 需要 做 些 改 进 : 如 果 我 们 有 关于 实现 的 问题 ， 
就 应 该 去 跟 Petra 确 认 。 如 果 她 也 不 肯定 ,她 会 安排 与 客户 进行 电话 会 议 ， 并 直接 和 客户 
沟通 。 

PETRA: 这 是 当然 , 我 在 这 里 就 是 为 你 们 获取 任何 你 们 所 需 的 客户 需求 细节 。 如 果 
你 没有 问 过 我 , 我 也 没有 在 故事 中 指定 足够 清晰 的 验收 标准 ， 那 一 定 是 有 关键 的 东西 被 
遗漏 了 。 

STEVE: David 说 的 这 个 问题 ,一 直 等 到 演示 会 议 上 再 去 询问 用 户 并 不 会 对 我 们 有 

多 大 影响 ， 但 是 对 于 其 他 一 些 更 重要 的 问题 ， 我 们 应 该 尽早 找到 正确 的 答案 。 

PETRA: 还 有 什么 需要 改进 的 吗 ? 如 果 没 有 ， 我 们 就 开始 讨论 下 一 个 话题 。 





12.6.4 ”什么 需要 保持 

团队 紧 接 着 开始 总 结 那 些 需 要 培养 成 习惯 的 积极 行动 。 

STEVE: 我 要 说 些 我 们 需要 保持 的 东西 。 我 们 改进 了 演示 的 准备 流程 ,并 且 取 得 了 
很 好 的 效果 。 我 们 应 该 把 这 个 记 下 来 并 坚持 ， 直 到 形成 习惯 。 

PETRA: 说 得 好 。 下 一 个 冲刺 会 证 明 这 个 冲刺 工作 质量 能 否 继续 保持 ， 或 者 只 是 个 
意外 , 所 以 记录 我 们 如 何 完成 这 个 优秀 的 冲刺 并 且 在 以 后 总 是 将 这 个 样板 过 程 牢 记 在 心 
会 是 一 个 很 好 的 主意 。 

STEVE: 还 有 什么 我 们 要 保持 的 ? 

DIANNE: 我 想不到 还 有 什么 我 们 特别 需要 保持 的 东西 了 。 


12.6.5“” 遇 到 了 什么 意料 之 外 的 事情 
回顾 会 议 中 找 出 这 些 意外 的 目的 是 让 团队 以 后 磁 到 这 些 事情 时 不 再 感到 意外 。 
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STEVE: 最 后 一 个 问题 : 这 个 冲刺 中 有 没有 我 们 后 续 需 要 研究 或 防止 出 现 的 意外 事 
项 ? 

DAVID: 我 对 这 个 冲刺 进行 得 这 么 好 感到 有 些 意外 ! 
团队 结束 了 这 次 回顾 会 议 ， 所 有 成 员 都 陆续 走出 了 会 议 室 ， 满 脸 洋 溢 着 对 冲刺 成 功 的 喜悦 。 





12.7 总 结 


第 二 个 冲刺 很 成 功 , 对 团队 而 言 是 一 个 改进 。 通 过 在 选择 方案 中 引入 目 适 应 代码 ,团队 展示 
了 在 敏捷 软件 开发 项 目 中 优雅 地 处 理 各 种 需求 变更 是 可 以 做 到 的 。 如 果 团 队 没 有 在 源 代 码 中 引入 
扩展 点 , 团队 成 员 要 增强 软件 功能 会 非常 困难 ,需要 大 量 的 重 写 、 重 构 , 或 者 将 已 有 代码 弄 得 文 
房 破 健 。 

















CE 


月 适应 工具 





本 附录 为 你 简要 介绍 如 何 使 用 Git 进 行 源 代码 控制 。 使 用 Git 可 以 获得 本 书 的 示例 代码 。 如 果 
你 以 前 使 用 过 Git， 那 么 一 定 很 清楚 这 个 源 代码 控制 软件 如 此 出 名 也 是 应 该 的 。 如 果 你 以 前 没有 
使 用 过 它 ， 本 附录 会 为 你 讲解 如 何 使 用 Git 管 理 本 地 和 远程 存储 库 。 这 些 技能 可 以 应 用 在 任何 存 
放 在 Git 上 的 存储 库 ; 因此 这 里 讲解 的 内 容 并 不 局 限于 本 书 的 代码 示例 。 有 很 多 车 名 的 开源 项 目 
都 在 使 用 Git， 也 有 很 多 公司 开始 使 用 Git 来 管理 他 们 自 有 的 代码 资产 。 

不 论 有 具体 实现 如 何 ， 持 续集 成 ( Continuous Integration，CI ) 系统 都 是 一 个 能 让 不 同 参与 者 
之 间 的 代码 始终 保持 同步 的 重要 工具 , 所 以 本 附录 中 有 一 节 简 要 讨论 了 持续 集成 的 概念 ， 并 介绍 
了 一 个 实施 持续 集成 的 通用 工作 流程 。 


A.1 使 用 Git 做 源 代 码 控制 


在 诸如 Mercurial 和 Git 这 样 的 分 布 式 源 代码 控制 系统 出 现 之 前 ， 源 代码 控制 的 理论 和 实践 在 
很 长 时 间 里 发 展 得 都 很 慢 。 使 用 任何 源 代 码 控制 系统 总 是 比 不 使 用 好 ， 但 我 肯定 首选 Git。 

通常 来 说 , 源 代码 控制 系统 就 是 为 了 追踪 代码 随 着 时 间 推 移 时 所 发 生 的 变更 , 通过 它 能 够 很 
容易 地 按照 时 间 线 前 后 遍历 代码 的 变更 ， 而 且 它 同时 也 能 提供 一 份 只 读 的 源 代码 备份 。 

使 用 Git， 每 个 开发 人 员 都 有 自 有 的 、 包 含 所 有 源 代 码 的 存储 库 ( 详 见 图 A-1 )。 为 了 编辑 源 
代码 ,开发 人 员 应 该 为 提交 连续 的 变更 创建 本 地 分 文 。 每 个 分 支 都 有 一 个 清楚 描述 的 目的 : 修复 
某 个 缺陷 ,实现 某 个 新 特性 ,或 改进 某 些 体验 。 不 论 目 的 是 什么 , 这 些 变更 都 只 在 本 地 的 存储 库 
中 发 生 ， 直 至 开发 人 员 决 定 把 代码 推送 到 其 他 的 远程 分 支 中 。 
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主 分 支 开发 分 支 特性 分 支 1 特性 分 支 2 
外 当 要 发 布 代码 时 ， 开 发 分 
支 会 被 合并 回 到 主 分 支 中 。 
@ 当 特性 分 支 的 变更 通过 评审 后 ， 
特性 分 支 会 被 合并 到 开发 分 支 。 


四 每 个 从 开发 分 支 扩展 出 的 分 支 
代表 着 一 个 新 特性 或 者 一 个 修 
复 缺陷 。 


@ 所 有 修改 都 不 会 直接 发 生 在 主 
分 支 上 ， 而 是 发 生 在 为 此 创建 


本 的 开发 分 支 上 。 


图 A-1 一 种 Git 分 支 策略 


尽管 理论 上 专门 设置 一 个 中 央 存 储 库 是 没有 必要 的 , 但 实际 应 用 中 通常 都 会 选择 某 个 存储 库 
作为 正式 的 源 代码 存放 位 置 , 参见 图 A-2。 在 一 个 开发 人 员 将 本 地 分 支 推 送 到 这 个 中 央 存 储 库 后 ， 
其 余 的 开发 人 员 都 陆续 接 到 请 求 以 将 该 分 支 包 含 的 新 变更 拉 进 他 们 本 地 存储 库 的 主 分 文中 。 这 被 
称 作 拉 请 求 (pull request )， 并 且 经 常用 在 有 助 于 保证 代码 质量 的 源 代 码 同 行 评审 活动 中 。 每 个 
代码 评审 者 可 以 根据 具体 情况 接受 或 者 拒绝 评审 中 代码 相关 的 拉 请 求 , 也 可 以 将 分 文 拉 进 自己 的 
本 地 存储 库 中 进行 编译 和 测试 。 如果 该 开发 者 提交 的 代码 变更 被 拒绝 了 , 他 可 以 继续 修改 并 再 次 
将 新 的 变更 推 人 中央 代码 库 直 至 获得 批准 。 然 后 ,每 个 获得 批准 的 拉 请 求 都 会 被 合并 到 一 个 主 开 
发 分 文中 , 其 他 的 开发 人 员 在 下 次 将 主 分 支 代 码 同步 到 本 地 存储 库 时 会 获取 到 所 有 已 经 获得 批准 
的 拉 请 求 中 包含 的 变更 。 如 果 需 要 ， 他 们 也 要 将 这 些 变更 合并 到 上 自己 本 地 正在 进行 的 分 文中 。 
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中 央 存 储 库 是 代码 
的 正式 存放 位 置 。 











Bob 将 它 的 分 支 推 
送 到 中 央 存 储 库 。 





Alice 和 Mark 将 Bob 的 
分 支 拉 进 本 地 存储 库 
中 以 做 测试 。 


每 个 开发 人 员 都 有 一 
个 中 央 存 储 库 的 本 地 
副本 。 


Bob Alice Mark 
图 A-2 分 布 式 源码 控制 是 一 种 点 对 点 系统 ， 但 实际 应 用 时 通常 会 设置 一 个 中 央 代 码 库 


A.2 ” Git 课程 


支持 Windows 平 台 的 Git 安 装 包 可 以 从 http://git-scem.com/download/win 下 载 。 

本 书 中 所 有 的 代码 清单 都 是 存放 在 GitHub 上 的 。GitHub 是 一 个 Git 存 储 库 社区 的 中 心 存储 库 。 

下 面 几 节 会 为 Git 的 初学 者 简要 介绍 如 何 浏览 Git 存 储 库 上 的 代码 。 相 比 完整 的 Git 介 绍 ， 这 几 
节 提 供 的 内 容 还 远 远 不 够 , 但 是 你 至 少 可 以 获取 本 书 代 码 示例 并 在 本 地 进行 编译 。 要 获得 更 多 的 
Git 使 用 帮助 ，Git 参 考 手 册 " 会 是 一 个 很 好 的 完整 介绍 。 

如 果 不 太 喜欢 使 用 命令 行 , http://git-scem.com/downloads/guis 上 也 有 好 几 球 不 错 的 带 有 用 户 界 
面 的 Git 工 具 ， 你 可 以 选择 下 载 自 己 喜 欢 的 。 在 我 写 这 本 书 时 ， 用 户 下 载 最 多 的 是 Atlassian 的 


SourceTree。 


A.2.1 克隆 存储 库 


获取 Git 仓 储 库 中 代码 的 第 一 步 就 是 克隆 指定 的 存储 库 。 所 有 Git 动 作 的 命令 都 是 git 命 令 行 应 
用 程序 的 参数 。 其 中 clone 命 令 需 要 提供 需要 克隆 的 目标 存储 库 的 位 置信 息 。 下 面 的 命令 示例 可 





GD http:/Wgitref org。 
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以 将 本 书 的 存储 库 殉 隆 到 本 地 。 记 住 ，Git 是 一 个 分 布 式 源 代码 控制 系统 ， 所 以 会 有 很 多 的 存储 
库 。 对 远程 存储 库 你 只 有 读 取 权 限 ， 但 对 克隆 得 到 的 本 地 存储 库 你 是 有 改写 权限 的 。 

git clone https://github.com/garymcleahhall/AdaptiveCode.git 

这 个 命令 会 在 你 本 地 的 工作 目录 下 生成 一 个 新 的 名 为 AdaptiveCode 的 子 目 录 。 默 认 选 择 的 是 
master 分 文 。 但 是 ， 本 书 的 每 个 示例 都 安排 在 不 同 的 分 文 上 ， 因 此 你 也 需要 知道 如 何 切换 分 支 。 


A.2.2 ”切换 分 支 





























克隆 好 新 的 存储 库 后 ， 可 以 使 用 改变 目录 命令 来 改变 你 本 地 存储 库 的 目录 。 

cd AdaptiveCode 

对 于 本 书 存 储 库 ， 当 前 默认 选择 的 分 文 是 master。 但 master 分 文 上 又 没有 多 少 东 西 ， 代 码 都 
安排 在 其 他 的 分 支 上 。 起 初 ， 只 将 master 分 支 克 隆 到 了 本 地 ， 其 余 的 分 支 都 没有 从 远程 存储 库 元 
隆 到 本 地 。 通 过 给 git 提 供 branch 命 令 ， 可 以 查看 本 地 可 用 的 分 支 清 单 。 

git branch 

这 个 命令 只 列 出 master 分 支 。 为 了 列 出 所 有 远程 的 分 支 ， 还 需要 在 branch 后 提供 remote 命 令 。 

git branch -remote 

这 个 命令 可 以 列 出 本 书 存 储 库 中 所 有 的 分 支 。 注 意 ， 所 有 分 文 都 以 origin/ 前 绥 开 头 ， 用 来 表 
明 这 些 分 支 所 在 的 远程 位 置 。 每 个 存储 库 可 以 同时 有 多 个 远程 位 置 ， 使 用 诸如 origin 的 名 称 可 以 
将 指定 的 远程 存储 库 克隆 到 本 地 。 

尽管 分 支 几 乎 可 以 使 用 任意 名 称 , 但 作为 个 人 喜好 , 我 还 是 为 本 书 存储 库 的 每 个 分 支 选 用 了 
chX- 这 个 名 称 前 缀 。chX 表 示 分 文 相关 的 章节 编号 ， 名 称 的 其 余部 分 是 对 分 文 内 容 的 简短 描述 。 
附录 B 提 供 了 一 个 包括 代码 清单 及 其 他 们 相应 的 分 文 名 称 的 参考 清单 。 现 在 ,通过 checkout 命 令 ， 
你 可 以 创建 远程 分 支 的 本 地 副本 并 切换 到 它 上 面 去 。 

git checkout ch9-problem-statement 

执行 这 个 命令 会 创建 远程 分 支 origin/ch9-problem-statement 的 本 地 版 本 , 并 且 将 当前 工作 目录 
切换 至 这 个 分 文 上 ， 以 便 后 续 改 动 都 只 作用 于 相应 的 本 地 分 文 。 列 举 当 前 工作 目录 的 内 容 ， 你 会 
看 到 如 下 清单 所 示 的 内 容 ， 其 中 有 一 个 名 为 DependencyInjectionMvc 的 新 目录 ， 它 包含 了 一 个 
Microsoft Visual Studio 解 决 方案 文件 以 及 一 些 该 方案 所 包含 子 项 目的 子 目 录 。 


C:\dev\AdaptiveCode [ch9-problem-statement]> 1s 









































Directory: C:\dev\AdaptiveCode 


Mode LastWriteTime Length Name 
d---- 3/16/2014 12:47 PM DependencyInjectionMvc 
-a--- 3/16/2014 12:47 PM 1522 .gitignore 


-a--- 3/16/2014 12:30 PM 84 README.md 
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如 果 你 切换 回 master 分 文 ， 这 个 文件 夹 会 被 删除 ， 因 为 它 与 当前 选择 的 分 文 已 经 无 关 了 。 


A.2.3 更 新 本 地 分 支 


如 果菜 个 时 候 分 支 的 远程 版 本 有 了 变更 ,你 也 想 获 取 这 些 最 新 的 变更 ， 那么 使 用 fetch 命 令 
就 可 以 下 载 远 程 分 文 的 所 有 变更 。 

git fetch 

如 采 你 不 指定 分 文 名 ,这 个 命令 会 下 载 所 有 分 文 , 包括 那些 新 创建 的 分 文 。 你 也 可 以 通过 指 
定 分 文 名 来 下 载 想 要 获取 的 分 文 。 


git fetch origin master 


注意 ， 上 面 的 命令 中 也 指明 了 远程 存储 库 的 名 称 ， 因 为 master 分 文 很 可 能 在 多 个 远程 存储 库 
中 都 存在 。 

使 用 fetch 命 令 下 载 分 支 变更 后 ， 你 可 以 使 用 checkout 命 令 切 换 至 目标 分 支 。 

git checkout ch9-problem-statement 

从 这 里 开始 , 本 地 分 文 就 不 再 与 远程 分 文 同步 ， 因 为 远程 变更 并 没有 再 被 克隆 到 本 地 。 使 用 
merge 命 令 可 以 将 远程 分 文 上 的 所 有 变更 合并 到 本 地 分 文中 。 

git merge origin/ch9-problem-statement 

执行 完 这 个 命令 后 , 所 有 远程 的 更 新 都 合并 到 了 本 地 ， 此 时 ,本 地 分 文 和 对 应 的 远程 分 文 是 
完全 相同 的 。 


A.3 持续 集成 


当 开 发 人 员 把 代码 推送 到 中 央 存 储 库 时 , 通常 会 在 服务 带 编 译 最 新 的 代码 。 这 种 对 开发 人 员 
所 做 代码 变更 的 持续 集成 能 提供 有 关 代 码 状态 的 非常 有 价值 的 及 时 反馈 。 如 果 编 译 失败 了 , 就 无 
法 满足 拉 请 求 验 收 的 第 一 个 标准 : 导致 无 法 构建 可 工作 版 本 的 任何 请 求 都 会 被 立刻 拒绝 。 

然而 ,仅仅 通过 编译 最 新 代码 是 无 法 确保 开发 人 员 为 修复 缺陷 或 实现 新 特性 所 做 的 变更 是 否 影 
啊 了 软件 的 其 他 部 分 。 因 此 , 在 代码 编译 成 功 后 , 持续 集成 系统 会 继续 运行 所 有 单元 测试 以 判断 是 
人 否 有 其 他 已 有 的 用 例 被 破坏 , 通过 所 有 单元 测试 后 , 系统 还 会 继续 检查 代码 的 单元 测试 覆盖 率 是 否 
满足 要 求 的 标准 。 完 成 所 有 这 些 步 又 后 ， 系 统 才 会 答 试 从 构建 的 输出 中 生成 可 供 部 署 的 安装 包 。 

所 有 这 些 步骤 是 顺序 执行 的 , 每 一 步 都 成 功 是 完成 持续 构建 流程 的 前 提 条 件 。 编 译 不 成 功 就 
无 需 再 运行 单元 测试 ; 类 似 地 ,单元 测试 未 通过 就 无 需 再 检查 代码 的 单元 测试 覆盖 率 ; 同样 ， 单 
元 测试 覆盖 率 没 有 达到 要 求 就 无 需 生 成 可 供 部 署 的 安装 包 。 持续 集成 系统 对 每 个 推送 的 分 文 都 执 
行 这 个 过 程 能 极 大 地 减轻 开发 人 员 的 负担 。 相 比 花费 大 量 时 间 手 动 完成 所 有 相关 任务 , 有 了 持续 
集成 系统 ， 开 发 人 员 只 需要 在 本 地 编译 代码 变更 涉及 的 工程 并 运行 针对 这 些 变 更 编写 的 单元 测 
试 ， 持 续集 成 系统 会 完成 其 余 所 有 的 工作 。 图 A-3 展 示 了 上 述 这 种 持续 集成 构建 流程 的 流程 图 。 
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提交 代码 





构建 解决 方案 








构建 成 功 与 否 ? 


运行 单元 测试 构建 失败 





所 有 测试 都 
成 功 了 吗 ? 


代码 的 单元 
测试 覆盖 率 












超过 了 要 求 
的 最 低 履 盖 
率 吗 ? 


没有 





部 署 产物 


图 A-3 一 个 简单 的 持续 集成 服务 的 流程 图 





用 尸 的 需求 经 常 变化 ， 每 个 开发 者 都 深 受 其 害 。 不 过 ， 如 
果 能 够 提高 代码 的 自 适应 性 ， 就 能 更 加 轻松 地 响应 变化 ， 避 人 免 
重复 劳动 。 本 书 介绍 了 敏捷 编程 的 最 佳 实践 、 原 则 和 模式 ， 能 
让 你 编写 出 灵活 的 自 适应 性 代码 ， 从 而 创造 更 大 的 商业 价值 。 
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